home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / bbs / pb_122.zip / PB122.DOC < prev    next >
Text File  |  1992-08-17  |  255KB  |  7,039 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.          ██████                 ██████                            ███
  22.           ██  ██                 ██  ██                            ██
  23.           ██  ██ ██ ███   ████   ██  ██  ████   ████   ██ ███      ██
  24.           █████   ███ ██ ██  ██  █████  ██  ██     ██   ███ ██  █████
  25.           ██      ██  ██ ██  ██  ██  ██ ██  ██  █████   ██  ██ ██  ██
  26.           ██      ██     ██  ██  ██  ██ ██  ██ ██  ██   ██     ██  ██
  27.          ████    ████     ████  ██████   ████   ██████ ████     ██████
  28.  
  29.  
  30.                                   Version 1.22
  31.                               (re-release of v1.21)
  32.  
  33.                                  August 17, 1992
  34.  
  35.  
  36.                    Copyright (c) 1990-1992 Philippe Leybaert
  37.                                All rights reserved
  38.  
  39.  
  40.  
  41.          ──────────────────────────────────────────────────────────────────
  42.  
  43.          The following names/products mentioned in this documentation are
  44.          copyrighted material, trademarks or registered trademarks:
  45.  
  46.          Bimodem                    Erik Labs
  47.          BNU                        David Nugent/Unique Computing Pty Ltd.
  48.          Borland C++, Turbo C++     Borland International, Inc
  49.          DESQview                   Quarterdeck Office Systems
  50.          DoorWay                    Marshall Dudley
  51.          DR DOS                     Digital Research
  52.          EFL (Enhanced File List)   Paul Tabara
  53.          FidoNet                    Tom Jennings
  54.          IBM PC/XT/AT               International Business Machines, Inc
  55.          MBUTIL                     Gerard van der Land
  56.          MS-DOS , Microsoft C       Microsoft, Inc
  57.          Multi-Edit                 American Cybernetics, Inc
  58.          Opus                       Wynn Wagner III
  59.          QuickBBS & QEcho           The QuickBBS Group, Inc
  60.          QuickEd                    Tirosh Bros.
  61.          RemoteAccess (RA)          Continental Software, Inc
  62.          TLIB                       Burton Systems Software
  63.          TosScan & FrontDoor        Joaquim H. Homrighausen
  64.          Turbo Assembler/Debugger   Borland International, Inc
  65.          X00                        Ray Gwinn
  66.          ZmailH                     Claude N. Warren
  67.          Zortech C++, BLink         Zortech, Inc
  68.          GECHO                      Gerard J. van der Land
  69.  
  70.          ──────────────────────────────────────────────────────────────────
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.                                       - 1 -
  94.  
  95.  
  96.  
  97.         ╒══════════════════════════════════════════════════════════════════╕
  98.         │░░░░░░ IMPORTANT INFORMATION - READ THIS FIRST ░░░░░░░░░░░░░░░░░░░│
  99.         ╘══════════════════════════════════════════════════════════════════╛
  100.  
  101.  
  102.          - The old USA registration address is no longer valid. To avoid
  103.            problems, please do not send any money to Mike Wagner in
  104.            Chaska, MN.
  105.  
  106.          - ProBoard (all executables and documentation files) is
  107.            copyrighted material of Philippe Leybaert.
  108.  
  109.          - You can use ProBoard for a period of 30 days, free of charge.
  110.            If you use the software after the evaluation period, you MUST
  111.            register.  (For registration information, see the appropriate
  112.            section of this manual)
  113.  
  114.          - After registration, you are allowed to use ProBoard for as long
  115.            as you like, and your registration is valid for all future
  116.            versions up to, but not including v2.00.  You will probably
  117.            receive a free upgrade to v2.00, but we do not guarantee this.
  118.  
  119.          - We reserve the right to quit giving support or releasing updates
  120.            of the software.
  121.  
  122.          - The software and other materials included in the distribution
  123.            archive are provided "AS IS" without warranty of any kind.  We do
  124.            not guarantee the correct functioning and/or reliability of the
  125.            software.  The authors will not be liable for any direct or
  126.            indirect damages, resulting from the use of the software.
  127.  
  128.          - You may not reverse-engineer ProBoard in any way and you may not
  129.            add, change or delete any files in the distribution archive.
  130.  
  131.          - You are free to distribute the original, unmodified ProBoard
  132.            archive provided no fee is charged for its distribution.  This
  133.            excludes charges for online time on electronic bulletin boards
  134.            or other communication services.
  135.  
  136.          - EFL.PEX, EFLCFG.EXE, and related files are copyrighted material
  137.            of Paul Tabara.
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.                                       - 2 -
  150.  
  151.  
  152.  
  153.         ╒══════════════════════════════════════════════════════════════════╕
  154.         │░░░░░░ CONTENTS ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  155.         ╘══════════════════════════════════════════════════════════════════╛
  156.  
  157.  
  158.                 INTRODUCTION ....................................   5
  159.                      - Description ..............................   5
  160.                      - Features .................................   6
  161.                      - Support ..................................   6
  162.                      - Technical Info ...........................   8
  163.                      - Credits ..................................   8
  164.  
  165.                 REGISTRATION ....................................  10
  166.  
  167.                 INSTALLATION ....................................  13
  168.                      - First Time Installation ..................  15
  169.                      - RemoteAccess to ProBoard .................  17
  170.                      - QuickBBS to ProBoard .....................  19
  171.  
  172.                 CONFIGURATION ...................................  20
  173.                      - Options (F1) .............................  20
  174.                      - Protocols (F2) ...........................  27
  175.                      - Message areas (F3) .......................  31
  176.                      - File areas (F4) ..........................  34
  177.                      - Time/download limits (F5) ................  36
  178.                      - User Editor (F6) .........................  37
  179.                      - Menu Editor (F7) .........................  40
  180.                      - Matrix Addresses (F8) ....................  41
  181.                      - Modem Parameters (F9) ....................  41
  182.                      - Events (Shift-F1) ........................  44
  183.                      - Personal Files (Shift-F2) ................  45
  184.                      - Edit Statistics (Shift-F3) ...............  46
  185.  
  186.                 SECURITY ........................................  47
  187.                      - Levels & Flags ...........................  47
  188.                      - Trashcan .................................  47
  189.  
  190.                 MENUS ...........................................  48
  191.                      - Setting up menus .........................  48
  192.                      - Menu Security ............................  49
  193.                      - Creating menus ...........................  50
  194.                      - Hints ....................................  52
  195.                      - Menu Function Summary ....................  53
  196.                      - Menu Function Overview ...................  55
  197.  
  198.                 USERS ...........................................  90
  199.                      - Loglevels ................................  90
  200.  
  201.  
  202.  
  203.  
  204.  
  205.                                       - 3 -
  206.  
  207.  
  208.  
  209.                 ECHOMAIL & NETMAIL ..............................  91
  210.                      - Echomail .................................  91
  211.                      - Netmail ..................................  91
  212.  
  213.                 PBUTIL ..........................................  93
  214.                      - Message Packer ...........................  94
  215.                      - Message Indexer ..........................  94
  216.                      - Message Linker ...........................  94
  217.                      - User File Packer .........................  95
  218.                      - User File Indexer ........................  95
  219.                      - User File Fixer ..........................  95
  220.                      - User Killer ..............................  96
  221.                      - File Counters ............................  97
  222.                      - Nodelist Compiler ........................  97
  223.                      - Music Player .............................  99
  224.  
  225.                 REFERENCE ....................................... 100
  226.                      - Multi-user operation ..................... 100
  227.                      - Sysop keys ............................... 101
  228.                      - Command line options & errorlevels ....... 104
  229.                      - AVATAR/0 and AVATAR/0+ ................... 107
  230.                      - Hard-coded .A?? files .................... 108
  231.                      - .A?? file control codes .................. 110
  232.                      - Music Files .............................. 113
  233.                      - Text Macros .............................. 114
  234.                      - Example batch files ...................... 117
  235.                      - Flag Cross-Reference Chart ............... 120
  236.                      - FREE Files ............................... 121
  237.  
  238.                 USER'S GUIDE TO PROBOARD ........................ 122
  239.                      - Navigating through menus ................. 122
  240.                      - The More Prompt .......................... 123
  241.                      - The [S] & [P] keys ....................... 123
  242.                      - Standard Chatting Procedure .............. 123
  243.  
  244.                 SOFTWARE DEVELOPMENT KIT ........................ 124
  245.  
  246.                 ENHANCED FILE LIST (EFL) PEX FILE ............... 125
  247.                      - FrontDoor Notes, High Speed Modems ....... 125
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                       - 4 -
  262.  
  263.  
  264.  
  265.         ╒══════════════════════════════════════════════════════════════════╕
  266.         │░░░░░ INTRODUCTION ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ │
  267.         ╘══════════════════════════════════════════════════════════════════╛
  268.  
  269.  
  270.  
  271.         ┌──────────────────────────────────────────────────────────────────┐
  272.         │ Description                                                      │
  273.         └──────────────────────────────────────────────────────────────────┘
  274.  
  275.          ProBoard is a program that allows you to run a public or private
  276.          BBS.  A BBS is a Bulletin Board, where files, messages and other
  277.          useful things may be exchanged between users. The operator of a
  278.          BBS is called the System Operator, or SysOp.  He/she is responsible
  279.          for the correct functioning of the BBS.  Therefore, this manual is
  280.          primarily intended for Sysops, or future Sysops.
  281.  
  282.          ProBoard has everything you need to efficiently run a BBS, and
  283.          more.
  284.  
  285.          It's even possible to use ProBoard within a mail network.
  286.          Furthermore, more than one user at a time can use a BBS running
  287.          ProBoard, by making use of a network or multitasker like
  288.          DESQview.
  289.  
  290.          The greatest asset of ProBoard is that it has most of the features
  291.          (and much MORE!) of QuickBBS and RemoteAccess, yet needs a small
  292.          amount of memory and disk storage space to run.  You could
  293.          run three copies of ProBoard on just one PC using Desqview. On
  294.          a 80386 computer with 4MB of RAM, you could run 4 nodes, and
  295.          still have a 600K DOS window at your disposal! When running an
  296.          external program, ProBoard can swap itself to disk/EMS, and stay
  297.          resident in only 2000 bytes !!!  The most important feature is
  298.          undoubtedly the ability to extend ProBoard by writing your own
  299.          extensions in C or C++.
  300.  
  301.          ProBoard uses RA/QuickBBS compatible message base files and user
  302.          files. All known utilities for RA v1.11 will work with this
  303.          version of ProBoard.
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.                                       - 5 -
  318.  
  319.  
  320.  
  321.         ┌──────────────────────────────────────────────────────────────────┐
  322.         │ Features                                                         │
  323.         └──────────────────────────────────────────────────────────────────┘
  324.  
  325.          This is a list of the most important features not found in other
  326.          BBS software:
  327.  
  328.          - A software development kit!  Write your own extensions to
  329.            ProBoard using C or C++. You can write "internal doors", and a
  330.            lot more!!  THIS IS UNIQUE!!
  331.          - Swaps itself to disk or EMS , leaving only 2 (two) Kb resident!
  332.          - Extremely flexible protection against excessive downloaders.
  333.          - REAL-TIME multi-line chat built in. No stupid line-per-line chat.
  334.          - Advanced CD-ROM support. The CD-ROM drive is not accessed
  335.            until a file is actually downloaded.
  336.          - VERY flexible protocol configuration. You can install all
  337.            protocols directly in ProBoard, including Zmodem,Xmodem,Puma,
  338.            Lynx, Bimodem (FULL support!),...
  339.          - Files can be downloaded from all areas at once, a single area
  340.            or from ANY combination of areas.
  341.          - You can set download-limits per file area (# files & # Kb)
  342.          - More control over the control codes in textfiles: left/right
  343.            aligned, fixed field length,...
  344.          - Sysop macros: you can assign keystrokes to function keys!
  345.          - Extremely fast!!
  346.          - IBM-specific characters can be filtered out for certain users.
  347.          - Personal files: users can exchange private files!
  348.          - Expiration dates. Let ProBoard lower a user's level at a given
  349.            date.
  350.          - Advanced support for extended text modes (132 columns)
  351.          - Extremely user-friendly configuration/maintenance.
  352.          - Unlimited customization
  353.          - Runs doors created for several major BBS packages, including
  354.            RemoteAccess (RA), QuickBBS, PC Board, and others.
  355.  
  356.  
  357.  
  358.  
  359.         ┌──────────────────────────────────────────────────────────────────┐
  360.         │ Support                                                          │
  361.         └──────────────────────────────────────────────────────────────────┘
  362.  
  363.          For problems, bug-reports, etc. please write to:
  364.  
  365.          Philippe Leybaert                        ProBoard USA
  366.          Groenplein 15                            Paul Tabara
  367.          B-9060 Zelzate                           P.O. Box 361
  368.          BELGIUM                                  Champlin, MN 55316
  369.                                                   USA
  370.  
  371.  
  372.  
  373.                                       - 6 -
  374.  
  375.  
  376.  
  377.          Or you can fax to the following number:  +32-91-444-938
  378.  
  379.          You can also reach the authors by sending E-mail:
  380.  
  381.          - Philippe Leybaert : FidoNet (2:291/1905.1)
  382.                                CompuServe (70314,2021)
  383.  
  384.          - Rutger Lasuy      : FidoNet (2:291/1905)
  385.  
  386.  
  387.          If you have any questions or comments, or you need utilities for
  388.          ProBoard, call one of the support boards:
  389.  
  390.          - Rivendell BBS - ProBoard Support USA (Fido 1:282/90)
  391.              Sysop: Paul Tabara
  392.              Hours: 24/24
  393.              Speed: 1200-14400 (v.32bis/v.42bis)
  394.              Tel  : (612) 323-9473
  395.  
  396.          - The Home of ProBoard - ProBoard Support Europe (Fido 2:292/1905)
  397.              Sysop: Rutger Lasuy
  398.              Hours: 24/24
  399.              Speed: 1200-14400 (v.32bis/v.42bis)
  400.              Tel  : +32-91-66-22-91
  401.  
  402.  
  403.          There is an international FidoNet ProBoard Support echo available.
  404.          Be sure to ask your Net Coordinator about it.  The name of the echo
  405.          is "PROBOARD".
  406.  
  407.          Although we try very hard, due to the volume of support requests
  408.          we receive from registered users, we can only offer limited support
  409.          to non-registered users.
  410.  
  411.          For the latest version of ProBoard and utilities, you can call one
  412.          of the support boards (above), or:
  413.  
  414.          - The O-Zone BBS (Fido 1:282/30)
  415.              Sysop: Jim Biggs
  416.              Hours: 24/24
  417.              Speed: 1200-14400 (HST/v32bis/v42bis)
  418.              Tel  : (612) 537-8659
  419.  
  420.          ProBoard is also available on CompuServe (IBMBBS forum).
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.                                       - 7 -
  430.  
  431.  
  432.  
  433.         ┌───────────────────────────────────────────────────────────────────┐
  434.         │ Technical Info                                                    │
  435.         └───────────────────────────────────────────────────────────────────┘
  436.  
  437.          ProBoard is entirely written in C++ and Assembler. No third-party
  438.          libraries are used, so we have TOTAL control over the code!
  439.  
  440.          For the development of ProBoard, we used the following tools:
  441.  
  442.          Compiler......... Borland C++ v3.0
  443.          Linker........... TLink, part of Borland C++ v3.0
  444.          Assembler........ Turbo Assembler v3.0
  445.          Debugger......... Turbo Debugger v3.0
  446.          Editor........... Multi-Edit Professional 6.0
  447.          Version Control.. TLIB v4.12f
  448.  
  449.  
  450.  
  451.         ┌───────────────────────────────────────────────────────────────────┐
  452.         │ Credits                                                           │
  453.         └───────────────────────────────────────────────────────────────────┘
  454.  
  455.          ProBoard and all the included utilities are written by:
  456.  
  457.              Philippe Leybaert and Rutger Lasuy
  458.  
  459.  
  460.          The documentation was written by Jim Biggs and Paul Tabara.
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.                                       - 8 -
  486.  
  487.  
  488.  
  489.          Beta-testing:
  490.  
  491.             ────────────────   ──────────────────────────   ───────────────
  492.             Sysop              System                       FidoNet Address
  493.             ────────────────   ──────────────────────────   ───────────────
  494.             Nolden Thrift      The Thrift Shop              1:151/803
  495.             Richard Vonzel     The File Cabinet BBS         1:282/27
  496.             Jim Biggs          The O-Zone BBS               1:282/30
  497.             Craig Peterson     FlightLine BBS               1:282/47
  498.             Tom Krueger        The Senate Chamber           1:282/56
  499.             Paul Tabara        Rivendell BBS                1:282/90
  500.             Greg Shaffer       Route 66 BBS                 1:370/510
  501.             Ed Ivey            Ed's Place                   1:3616/1
  502.             Andy Smith         The Business Connection      1:3645/10
  503.             Johan Widingsjo    Flash Gordon                 2:201/415
  504.             Steven Debruyn     Magic BBS                    2:292/1201
  505.             Tim De Meyer       MultiNet Home Base           2:292/1400
  506.             Marc Van Loocke    ProBoard Support Benelux     2:292/1900
  507.             Koen Weytens       Line Up II                   2:292/1904
  508.             Patrick Thijs      Connect BBS                  2:294/40
  509.             Allan Soreyn       Electro-Line BBS             2:296/120
  510.             Eddy Impens        F-Three BBS                    (n/a)
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.                                       - 9 -
  542.  
  543.  
  544.  
  545.         ╒══════════════════════════════════════════════════════════════════╕
  546.         │░░░░░░ REGISTRATION ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ │
  547.         ╘══════════════════════════════════════════════════════════════════╛
  548.  
  549.          ProBoard is SHAREWARE.  This means that you are granted a 30-day
  550.          evaluation period, after which you must register.  You will receive
  551.          a registration key file through netmail or it will be uploaded to
  552.          your BBS if you don't have a FidoNet node number.  If none of this
  553.          is possible, please indicate this on your registration form, along
  554.          with what size diskette you need and we will mail you your key
  555.          on a diskette.  Arrangements can also be made for you to download
  556.          your key from the ProBoard USA support BBS.  The key file is valid
  557.          for all future versions of ProBoard up to 2.00.
  558.  
  559.          Registration fees for non-commercial use are as follows:
  560.  
  561.              USA.................    40 US$
  562.              Canada..............    50 CAN$
  563.              Belgium.............  1500 BF
  564.              The Netherlands.....    85 FL
  565.              UK..................    25 BP
  566.              Germany.............    75 DM
  567.              France..............   275 FF
  568.  
  569.  
  570.          When you use ProBoard in a commercial environment, multiply the
  571.          registration-prices by 5.  Commercial registrations include
  572.          the printed & bound ProBoard manual and free support by fax/bbs.
  573.  
  574.          To register, print the registration form on the next page,
  575.          fill it out, and send it together with your payment (check or
  576.          money order) to the following address:
  577.  
  578.          For the USA and Canada:
  579.  
  580.             ProBoard USA
  581.             c/o Paul Tabara
  582.             P.O Box 361
  583.             Champlin, MN 55316
  584.             USA
  585.  
  586.          In the United States and Canada, make checks payable to
  587.          Paul Tabara.  (US Currency only!)
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.                                       - 10 -
  598.  
  599.  
  600.  
  601.          For Europe:  (Use a "EuroCheque" for your registration!)
  602.  
  603.              Rutger Lasuy
  604.              Krakeelstraat 5
  605.              B-9260 Serskamp
  606.              BELGIUM
  607.  
  608.          If you live in Belgium, you can transfer the registration amount
  609.          (1500 BF) to our account number: 449-2774401-84.
  610.  
  611.  
  612.  
  613.  
  614.  
  615.  
  616.  
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.                                       - 11 -
  654.  
  655.  
  656.  
  657.          ------------------------------------------------------------------
  658.                ProBoard version 1.22     ----     Registration Form
  659.          ------------------------------------------------------------------
  660.  
  661.  
  662.          Your Name    :  _____________________________________________
  663.  
  664.          Company      :  _____________________________________________
  665.  
  666.          Sysop Name   :  _____________________________________________
  667.  
  668.          BBS name     :  _____________________________________________
  669.  
  670.          Note: if we can not deliver your key via FidoNet, or a call to
  671.          your BBS, please indicate which diskette size you prefer below
  672.          and a key file will be mailed to you.
  673.  
  674.          Diskette-size:  ( ) - 5"1/4        ( ) - 3"1/2    (check one)
  675.  
  676.          Address      :  _____________________________________________
  677.  
  678.                          _____________________________________________
  679.  
  680.                          _____________________________________________
  681.  
  682.  
  683.          Primary BBS phone number : __________________________________
  684.  
  685.          Hours of operation       : __________________________________
  686.  
  687.          Is your system part of FidoNet?   ( ) - Yes          ( ) - No
  688.  
  689.          If so, what is your network address?  _______________________
  690.  
  691.          Type of registration:   ( ) - Personal       ( ) - Commercial
  692.  
  693.          Registration amount enclosed: _______________________________
  694.  
  695.  
  696.          What would you like to see added or changed in future versions?
  697.  
  698.          _____________________________________________________________
  699.  
  700.          _____________________________________________________________
  701.  
  702.          _____________________________________________________________
  703.  
  704.          _____________________________________________________________
  705.  
  706.  
  707.  
  708.  
  709.                                       - 12 -
  710.  
  711.  
  712.  
  713.         ╒══════════════════════════════════════════════════════════════════╕
  714.         │░░░░░░ INSTALLATION ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  715.         ╘══════════════════════════════════════════════════════════════════╛
  716.  
  717.  
  718.          If you currently operate either a RemoteAccess or QuickBBS bulletin
  719.          board system, continue reading this chapter for specific instructions
  720.          on how to convert your existing system to ProBoard.
  721.  
  722.          The system-requirements for ProBoard are:
  723.  
  724.                - DOS v3.30 or higher
  725.                - 350 Kb of free system memory (180 Kb for the overlayed
  726.                  version of PROBOARD.EXE)
  727.                - A FOSSIL driver (eg. X00 or BNU)
  728.  
  729.          A FOSSIL driver can be obtained from many BBS's (including from
  730.          the ProBoard Support BBS).
  731.  
  732.  
  733.          The following guidelines are intended for a single-user system.
  734.          Please refer to the appropriate section on how to install a
  735.          multi-user system.
  736.  
  737.          ProBoard is distributed in a compressed file (PB_122.ARJ). Make
  738.          the following subdirectory for ProBoard to be installed in.
  739.  
  740.             C:\PB           (the main ProBoard directory)
  741.  
  742.          Unzip PB_122.ARJ in C:\PB in order to obtain the following files:
  743.  
  744.             PROBOARD.EXE            ProBoard executable
  745.             PROCFG.EXE              ProBoard configuration program
  746.             PBUTIL.EXE              Maintenance utility
  747.             PB122.DOC               This file
  748.             PB122SDK.DOC            Documentation on the ProBoard SDK
  749.             P.BAT                   Basic batch file
  750.             EX_MNU.ARJ              Example menus
  751.             EX_TXT.ARJ              Example ANS/ASC files
  752.             EX_CFG.ARJ              Example configuration files
  753.             CONVERT.EXE             Conversion utility
  754.             SDK.ARJ                 ProBoard Software Development Kit (PEX)
  755.             EFL130.ARJ              Pre-release of "Enhanced File List" (EFL)
  756.                                     (Sample PEX File)
  757.  
  758.          Now, you need to create the following subdirectories.
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.                                       - 13 -
  766.  
  767.  
  768.  
  769.             C:\PB\MENUS     (where your menus will be stored)
  770.             C:\PB\TXTFILES  (for the text files that ProBoard will use)
  771.             C:\PB\MSGBASE   (where your messages will be stored)
  772.             C:\PB\PEX       (where ProBoard Executable (PEX) files are stored)
  773.             C:\PB\PVTFILES  (where "Private" files to/from users are placed)
  774.             C:\PB\ULOADS    (where files users upload will be placed)
  775.             C:\PB\DLOADS    (where files users can download will be kept.)
  776.  
  777.  
  778.          With previous versions of ProBoard (1.0x), you had to set 2
  779.          environment variables (PROBOARD and DSZLOG).  This is not
  780.          necessary with this version.  ProBoard looks for its data
  781.          files in the directory where PROBOARD.EXE is located.  You can,
  782.          however, tell ProBoard to look for the data files in another
  783.          directory by setting the environment variable PROBOARD (eg. SET
  784.          PROBOARD=F:\PB).  The environment variable DSZLOG used by most
  785.          protocols is not needed.  ProBoard will set this variable prior to
  786.          starting the protocol.
  787.  
  788.          ProBoard is now ready to be configured by ProCFG. This is
  789.          discussed in the next chapter titled "Configuration".
  790.  
  791.          Once ProBoard is installed, you should start it with a batch file.
  792.          ProBoard should ALWAYS be run with a batch file, because it returns
  793.          to DOS when a user logs off.
  794.  
  795.          Below is a basic batch file for stand-alone operation (without a
  796.          mailer).  It is called P.BAT and is included in PB_122.ARJ
  797.  
  798.            :again
  799.                 PROBOARD -S
  800.                 if errorlevel 99 goto out
  801.                 if errorlevel 1 goto fatal
  802.                 goto again
  803.  
  804.            :fatal
  805.                 echo A fatal error occured.
  806.                 goto x
  807.  
  808.            :out
  809.                 echo Normal exit.
  810.  
  811.            :x
  812.  
  813.          Note that errorlevels 2-4 generate a fatal error. These error-
  814.          levels are used for mail networking, and ProBoard should not
  815.          return one of these errorlevels in a standalone environment.
  816.  
  817.          The PROBOARD.EXE command line options are discussed in the
  818.          "Reference" chapter later in this manual.
  819.  
  820.  
  821.                                       - 14 -
  822.  
  823.  
  824.  
  825.         ┌──────────────────────────────────────────────────────────────────┐
  826.         │ First-Time Installation                                          │
  827.         └──────────────────────────────────────────────────────────────────┘
  828.  
  829.          Most people want to unpack the ProBoard files, and want to see
  830.          something working right away.  This section explains what to do to
  831.          get your system up and running quickly.
  832.  
  833.          We will assume that you created (see above) the directory C:\PB
  834.          as ProBoard's main system directory.
  835.  
  836.          1. Create the following directories:
  837.  
  838.                C:\PB\MENUS
  839.                C:\PB\TXTFILES
  840.                C:\PB\PEX
  841.                C:\PB\MSGBASE
  842.  
  843.          2. Unpack ProBoard in the directory C:\PB
  844.  
  845.          3. Unpack the file EX_TXT.ARJ in the directory C:\PB\TXTFILES
  846.  
  847.          4. Unpack the file EX_MNU.ARJ in the directory C:\PB\MENUS
  848.  
  849.          5. Unpack the file SDK.ARJ in the directory C:\PB\PEX
  850.  
  851.          6. Unpack the file EX_CFG.ARJ in the directory C:\PB
  852.  
  853.          7. Run ProCFG and enter the correct modem parameters for your
  854.             modem (explained in the next chapter, "Configuration")
  855.  
  856.  
  857.          After these seven steps you can run ProBoard, but you will not be
  858.          able to use the fullscreen editor or perform file transfers.
  859.          To log in locally, you execute PROBOARD.EXE without parameters. To
  860.          make ProBoard answer incoming calls, run PROBOARD -S.
  861.  
  862.  
  863.           8. Run ProCFG and create some file and message areas. (explained
  864.              in the next chapter, "Configuration")
  865.  
  866.           9. Download QuickED from a BBS, copy it in the directory C:\PB and
  867.              run the QuickED configuration program. (QuickED can be found on
  868.              any ProBoard Support BBS)
  869.  
  870.  
  871.  
  872.  
  873.  
  874.  
  875.  
  876.  
  877.                                       - 15 -
  878.  
  879.  
  880.  
  881.          10. Download DSZ from a BBS and copy the file DSZ.COM or DSZ.EXE in
  882.              the directory C:\PB. (DSZ can be found on any ProBoard Support
  883.              BBS)
  884.  
  885.  
  886.          Now, you will be able to run ProBoard, use the fullscreen editor,
  887.          and allow users to perform file transfers using X,Y & Zmodem.
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.  
  932.  
  933.                                       - 16 -
  934.  
  935.  
  936.  
  937.         ┌──────────────────────────────────────────────────────────────────┐
  938.         │ RemoteAccess to ProBoard Conversion                              │
  939.         └──────────────────────────────────────────────────────────────────┘
  940.  
  941.  
  942.         If you are operating a RemoteAccess system, you can convert your
  943.         existing userfile, message files, message areas, file areas and
  944.         menus to the format used by ProBoard.  This is done by running
  945.         CONVERT.EXE in the ProBoard system directory.  But, before you do
  946.         ANYTHING, we highly recommend that you back up your existing
  947.         files.
  948.  
  949.          Here's the procedure to follow:
  950.  
  951.          - Backup your existing files.
  952.          - Install ProBoard as explained earlier (don't forget to setup
  953.            and create all directories needed by ProBoard)
  954.          - Move to the ProBoard system directory (usually C:\PB).
  955.          - Copy the following files from your RA message base directory to
  956.            the ProBoard message base directory: USERS.BBS, USERSXI.BBS,
  957.            LASTREAD.BBS, MSGINFO.BBS, MSGHDR.BBS, MSGTXT.BBS, MSGIDX.BBS,
  958.            MSGTOIDX.BBS.
  959.          - Run CONVERT RA <ra-dir>
  960.              eg. CONVERT RA C:\RA
  961.          - Run PBUTIL with the UF parameter.
  962.              eg. PBUTIL UF
  963.  
  964.          Things you will have to do manually:
  965.  
  966.              - Enter all system parameters in ProCFG (like paths).
  967.              - Enter the user levels & download limits in ProCFG
  968.              - Check all file- and message-related functions for the
  969.                correct data fields. ProBoard uses a different (more
  970.                advanced) method for specifying areas.
  971.              - Enter any events you have in PROCFG.
  972.              - Copy any .Q-A files to the ProBoard directory.
  973.              - If you had a "Message to Sysop" /T=User_Name in RA, find
  974.                that entry in your new ProBoard menu.  Change it to
  975.                /T="User Name" (Note: NO UNDERSCORE!!)
  976.  
  977.  
  978.  
  979.         ┌──────────────────────────────────────────────────────────────────┐
  980.         │ RA Compatible Files                                              │
  981.         └──────────────────────────────────────────────────────────────────┘
  982.  
  983.          ProBoard uses different files than RA to store the file area and
  984.          message area configurations.  Therefore, to run any of your
  985.          RA-utilities that use the files CONFIG.RA, FILES.RA, MESSAGES.RA,
  986.          TIMELOG.BBS and SYSINFO.BBS, you must first run a conversion.
  987.  
  988.  
  989.                                       - 17 -
  990.  
  991.  
  992.  
  993.          Use the CONVERT utility (Supplied with PB_122.ARJ) to create these
  994.          files from the ProBoard system files.  Run 'CONVERT SIMUL' in the
  995.          ProBoard system directory to create the following files:
  996.  
  997.              CONFIG.RA
  998.              FILES.RA
  999.              MESSAGES.RA
  1000.              TIMELOG.BBS
  1001.              SYSINFO.BBS
  1002.  
  1003.          You must run this conversion before you attempt to use your
  1004.          favorite RA utilities.  This needs to be done only once initally,
  1005.          and then thereafter only when you have made changes to ProBoard
  1006.          using PROCFG.EXE.  You do not need to run 'CONVERT SIMUL' each
  1007.          time you run one of your RA utilities.
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.                                       - 18 -
  1046.  
  1047.  
  1048.  
  1049.         ┌──────────────────────────────────────────────────────────────────┐
  1050.         │ QuickBBS to ProBoard Conversion                                  │
  1051.         └──────────────────────────────────────────────────────────────────┘
  1052.  
  1053.  
  1054.          If you are operating a QuickBBS system, you can convert your
  1055.          existing userfile, message files, message areas, file areas and
  1056.          menus to the format used by ProBoard.  This is done by running
  1057.          CONVERT.EXE in the ProBoard system directory.  But before you do
  1058.          ANYTHING, we highly recommend that you back up your existing files.
  1059.  
  1060.          Here's the procedure to follow:
  1061.  
  1062.          - Backup your existing files.
  1063.          - Install ProBoard as explained earlier (don't forget to setup
  1064.            and create all directories needed by ProBoard)
  1065.          - Move to the ProBoard system directory (usually C:\PB).
  1066.          - Copy the following files from your QBBS message base directory to
  1067.            the ProBoard message base directory: USERS.BBS, LASTREAD.BBS,
  1068.            MSGINFO.BBS, MSGHDR.BBS, MSGTXT.BBS, MSGIDX.BBS and MSGTOIDX.BBS.
  1069.          - Run CONVERT QBBS <QBBS-dir>
  1070.              eg. CONVERT QBBS C:\QUICKBBS
  1071.          - Run PBUTIL with the UF parameter.
  1072.              eg. PBUTIL UF
  1073.  
  1074.          Things you will have to do manually:
  1075.  
  1076.              - Enter all system parameters in ProCFG (like paths).
  1077.              - Enter the user levels & download limits in ProCFG
  1078.              - Check all file- and message-related functions for the
  1079.                correct data fields. ProBoard uses a different (more
  1080.                advanced) method for specifying areas.
  1081.              - Enter the events you have in PROCFG.
  1082.              - Copy any .Q-A files to the ProBoard directory.
  1083.              - If you had a "Message to Sysop" /T=User_Name in QBBS, find
  1084.                that entry in your new ProBoard menu.  Change it to
  1085.                /T="User Name" (Note: NO UNDERSCORE!!)
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.                                       - 19 -
  1102.  
  1103.  
  1104.  
  1105.         ╒══════════════════════════════════════════════════════════════════╕
  1106.         │░░░░░░ CONFIGURATION ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  1107.         ╘══════════════════════════════════════════════════════════════════╛
  1108.  
  1109.  
  1110.          ProBoard is completely configured by PROCFG.EXE. This program can
  1111.          be executed from any directory. In most of the menus, just press
  1112.          <Ins> to add an item, press <Del> to remove an item, and press
  1113.          <Enter> to select an item.
  1114.  
  1115.  
  1116.  
  1117.         ┌──────────────────────────────────────────────────────────────────┐
  1118.         │ Options (F1)                                                     │
  1119.         └──────────────────────────────────────────────────────────────────┘
  1120.  
  1121.          This is the first option to choose when running PROCFG.EXE. A
  1122.          second menu will be displayed with the following items:
  1123.  
  1124.             - Paths
  1125.             - New Users
  1126.             - Security
  1127.             - Yelling
  1128.             - System Options
  1129.             - File Transfer
  1130.             - Display Options
  1131.             - Text Strings
  1132.             - Site Info
  1133.  
  1134.          A description of these fields follows.
  1135.  
  1136.  
  1137.  
  1138.         ┌──────────────────────────────────────────────────────────────────┐
  1139.         │ Paths                                                            │
  1140.         └──────────────────────────────────────────────────────────────────┘
  1141.  
  1142.          Textfiles ................... Directory where ProBoard's textfiles
  1143.                                        are stored (drive included!).
  1144.  
  1145.          Menus ....................... Directory where ProBoard's menus are
  1146.                                        stored (drive included!).
  1147.  
  1148.          Message Base ................ Directory where the message base
  1149.                                        will be stored (drive included!).
  1150.  
  1151.          Uploads ..................... Directory where the users' uploads
  1152.                                        will be stored (drive included!).
  1153.  
  1154.  
  1155.  
  1156.  
  1157.                                       - 20 -
  1158.  
  1159.  
  1160.  
  1161.          Private Uploads ............. Directory where personal files
  1162.                                        are stored. (for file exchanges
  1163.                                        between users).
  1164.  
  1165.          Nodelist Directory .......... Directory where the nodelist is
  1166.                                        located. For use by the nodelist
  1167.                                        compiler. Leave this field blank
  1168.                                        if you do not have a nodelist.
  1169.  
  1170.          PEX Files ................... Directory where the PEX files should
  1171.                                        be stored.
  1172.  
  1173.          Editor Command .............. The external editor's filename and
  1174.                                        path (eg. C:\PB\QUICKED.EXE). You
  1175.                                        can also use shell options here
  1176.                                        (refer to menu type 7 for more
  1177.                                        info). Example: *SQUICKED.EXE
  1178.  
  1179.                                        If you are not using an external
  1180.                                        editor, leave this field blank and
  1181.                                        ProBoard will default to it's
  1182.                                        internal editor.
  1183.  
  1184.  
  1185.  
  1186.         ┌──────────────────────────────────────────────────────────────────┐
  1187.         │ New Users                                                        │
  1188.         └──────────────────────────────────────────────────────────────────┘
  1189.  
  1190.          New User Level .............. The level a user will have upon his
  1191.                                        or her first login.
  1192.  
  1193.          New User Flags .............. The flags a user will have upon his
  1194.                                        or her first login.
  1195.  
  1196.          New User Loglevel ........... The loglevel a user will have upon
  1197.                                        his or her first login (more info
  1198.                                        about this later).
  1199.  
  1200.          Allow ANSI .................. Allows New Users to select ANSI
  1201.                                        terminal emulation.
  1202.  
  1203.          Allow AVATAR ................ Allow new users to select either
  1204.                                        AVATAR/0 or AVATAR/0+ terminal
  1205.                                        emulation.
  1206.  
  1207.          Ask Phone Number ............ Determines whether ProBoard should
  1208.                                        ask for a user's phone number upon
  1209.                                        his/her first login.
  1210.  
  1211.  
  1212.  
  1213.                                       - 21 -
  1214.  
  1215.  
  1216.  
  1217.         ┌──────────────────────────────────────────────────────────────────┐
  1218.         │ Security                                                         │
  1219.         └──────────────────────────────────────────────────────────────────┘
  1220.  
  1221.          Allow Quick Login ........... If this is enabled, the Sysop can
  1222.                                        login as Sysop by pressing [Enter]
  1223.                                        at the login prompt without
  1224.                                        entering a password. If you don't
  1225.                                        like this, just turn it off.
  1226.  
  1227.          Write Pwd-Failure Messages .. If a user fails to log in because
  1228.                                        he/she exceeded the maximum number
  1229.                                        of password retries, ProBoard can
  1230.                                        write a security message to that
  1231.                                        person and to the Sysop, telling
  1232.                                        him/her what happened. This can be
  1233.                                        turned on or off with this option.
  1234.  
  1235.          Allow Login With Alias ...... Determines if ProBoard will allow
  1236.                                        users to login with their alias
  1237.                                        (handle).  Users can also select or
  1238.                                        change their alias using Menu
  1239.                                        Function 59.  If this option is set
  1240.                                        to "No", ProBoard will not ask new
  1241.                                        users to select an alias.
  1242.  
  1243.          Log Local Calls ............. If this option is enabled, all local
  1244.                                        logins will be logged in the file
  1245.                                        PROBOARD.LOG (ProBoard's system log).
  1246.  
  1247.          Hide Sysop Activity ......... If enabled, ProBoard will hide all
  1248.                                        Sysop activity from the Last Callers
  1249.                                        list (Function 51), Show Users Online
  1250.                                        (Function 50), and from the display of
  1251.                                        the User List (Function 13).
  1252.  
  1253.          Max. Password Retries ....... Maximum number of incorrect password
  1254.                                        attempts ProBoard will allow, before
  1255.                                        logging the user off.
  1256.  
  1257.          Min. Password Length ........ The minimum length of a password.
  1258.  
  1259.          Security Message Area ....... The message area number where
  1260.                                        ProBoard's Security Manager should
  1261.                                        write it's security related messages.
  1262.  
  1263.          Level For Crashmail ......... Level needed to send crashmail.
  1264.  
  1265.          Flags For Crashmail ......... Flags needed to send crashmail.
  1266.  
  1267.  
  1268.  
  1269.                                       - 22 -
  1270.  
  1271.  
  1272.  
  1273.          Level For Fileattach ........ Level needed to do a file attach
  1274.                                        for Netmail.
  1275.  
  1276.          Flags For Fileattach ........ Flags needed to do a file attach
  1277.                                        for Netmail.
  1278.  
  1279.          Use System Password ......... (Yes/No). If set to "Yes", ProBoard
  1280.                                        will require all incoming callers to
  1281.                                        know and enter a 'System Password'
  1282.                                        before asking them for their user
  1283.                                        name and user password.  Great for
  1284.                                        running a 'Private' BBS in a
  1285.                                        corporation, etc.  If set to "No"
  1286.                                        users will not be prompted for a
  1287.                                        'System Password'.
  1288.  
  1289.          System Password ............  If the above option 'Use System
  1290.                                        Password' is set to 'Yes', this is
  1291.                                        the password users are required to
  1292.                                        enter to gain access to the BBS.
  1293.                                        Users who fail logging in (perhaps
  1294.                                        they forgot or do not know the
  1295.                                        system password), will be allowed
  1296.                                        to enter a message to the SysOp
  1297.                                        explaining their situation, after
  1298.                                        which, ProBoard will log the user
  1299.                                        off.
  1300.  
  1301.  
  1302.  
  1303.         ┌──────────────────────────────────────────────────────────────────┐
  1304.         │ Yelling                                                          │
  1305.         └──────────────────────────────────────────────────────────────────┘
  1306.  
  1307.          Max. Sysop Pages ............ Number of times a user can page the
  1308.                                        Sysop during one session.
  1309.  
  1310.          PageBell Length ............. Number of seconds the Sysop paging
  1311.                                        bell will ring.
  1312.  
  1313.          Page Start Time ............. Users can only yell during these
  1314.          Page End Time ............... hours (in 24 hour format).
  1315.  
  1316.  
  1317.  
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.  
  1325.                                       - 23 -
  1326.  
  1327.  
  1328.  
  1329.         ┌──────────────────────────────────────────────────────────────────┐
  1330.         │ System Options                                                   │
  1331.         └──────────────────────────────────────────────────────────────────┘
  1332.  
  1333.          Check Mail At Login ......... Determines whether ProBoard should
  1334.                                        check for new mail and files upon
  1335.                                        login. If set to "Ask", ProBoard will
  1336.                                        ask the user if they want to check
  1337.                                        for waiting mail/personal files.
  1338.  
  1339.          Allow One-Word Names ........ Determines whether a user's name can
  1340.                                        be a single word.
  1341.  
  1342.          Date Format ................. Determines if ProBoard should display
  1343.                                        all dates in European format (DD/MM/YY)
  1344.                                        or American format (MM/DD/YY).
  1345.  
  1346.          Use File Sharing ............ Set this option to "Yes", if you want
  1347.                                        to share the message base with
  1348.                                        FrontDoor or any other utility that
  1349.                                        uses the same locking scheme as
  1350.                                        RemoteAccess 1.10 / FrontDoor 2.02
  1351.  
  1352.          Swap to Disk ................ Determines the default shelling mode.
  1353.                                        If this option is set to ON, ProBoard
  1354.                                        will be swapped to disk/EMS, leaving
  1355.                                        only 2000 bytes resident!
  1356.  
  1357.          Fast Mode ................... When this option is enabled,
  1358.                                        ProBoard will use about 10Kb more
  1359.                                        memory (depending on the number
  1360.                                        of file-areas), but the system
  1361.                                        will run faster.
  1362.  
  1363.          Kill Netmail When Sent ...... Controls whether netmail will be
  1364.                                        killed after a message has been
  1365.                                        exported from the messagebase.
  1366.  
  1367.          Inactivity Limit ............ Number of seconds a user is allowed
  1368.                                        to remain idle.  If the user hasn't
  1369.                                        typed anything when this limit is
  1370.                                        exceeded, they will be logged off.
  1371.  
  1372.          Quote String ................ This string is used to when ProBoard
  1373.                                        quotes a message for a reply.
  1374.                                        A '@' character is replaced by the
  1375.                                        initials of the user who wrote the
  1376.                                        message quoted from.
  1377.  
  1378.  
  1379.  
  1380.  
  1381.                                       - 24 -
  1382.  
  1383.  
  1384.  
  1385.          Password Display ............ Enter the character that you want
  1386.                                        ProBoard to display to users, as
  1387.                                        they enter their password.
  1388.  
  1389.          # Usage Graph Days .......... Enter the number of days you would
  1390.                                        like to have displayed on your
  1391.                                        system usage graphs.
  1392.  
  1393.  
  1394.  
  1395.         ┌──────────────────────────────────────────────────────────────────┐
  1396.         │ File Transfer                                                    │
  1397.         └──────────────────────────────────────────────────────────────────┘
  1398.  
  1399.          Minimum Upload Space ........ Space needed on the upload drive for
  1400.                                        uploads to be allowed.
  1401.  
  1402.          Download Start Time ......... The time that users can begin
  1403.                                        downloading files (Except when
  1404.                                        the "Ignore DL" flag is set in the
  1405.                                        user's record).
  1406.  
  1407.          Download End Time ........... The time after which downloads can
  1408.                                        not be performed (except when the
  1409.                                        "Ignore DL" flag is set in the users
  1410.                                        record).
  1411.  
  1412.  
  1413.  
  1414.         ┌──────────────────────────────────────────────────────────────────┐
  1415.         │ Display Options                                                  │
  1416.         └──────────────────────────────────────────────────────────────────┘
  1417.  
  1418.          Use 43/50 Line Mode ......... Enable local display of ProBoard in
  1419.                                        43 or 50 line mode.
  1420.  
  1421.          Show User Info Window ....... Should ProBoard display the User
  1422.                                        Info Window, when users are online.
  1423.  
  1424.  
  1425.  
  1426.         ┌──────────────────────────────────────────────────────────────────┐
  1427.         │ Text Strings                                                     │
  1428.         └──────────────────────────────────────────────────────────────────┘
  1429.  
  1430.  
  1431.          Start Chat .................. displayed to the user when you
  1432.                                        press <ALT-C> to enter into chat
  1433.                                        mode.
  1434.  
  1435.  
  1436.  
  1437.                                       - 25 -
  1438.  
  1439.  
  1440.  
  1441.          End Chat .................... displayed to user when you press
  1442.                                        <ESC> to end chat mode.
  1443.  
  1444.          Scanning User File .......... displayed to user during login,
  1445.                                        after user has been asked for their
  1446.                                        name, but before they are asked for
  1447.                                        their password.
  1448.  
  1449.          Editing User Record ......... displayed to a user who is online,
  1450.                                        when you press <ALT-E> to invoke the
  1451.                                        user editor to edit their user
  1452.                                        record.
  1453.  
  1454.          Sysop DOS Shell ............. displayed to user who is online,
  1455.                                        when you press <ALT-J> to jump
  1456.                                        (shell) to DOS.
  1457.  
  1458.          Returned From DOS ........... displayed to user when you type the
  1459.                                        DOS "EXIT" command to return to the
  1460.                                        BBS, after jumping/shelling to DOS.
  1461.  
  1462.          Shelling .................... displayed to the user when an
  1463.                                        external program is run.
  1464.  
  1465.          Checking for mail ........... displayed to the user when they
  1466.                                        check to see if they have any
  1467.                                        mail waiting.
  1468.  
  1469.          No mail found ............... displayed to the user after ProBoard
  1470.                                        has checked for waiting mail, but
  1471.                                        none was found.
  1472.  
  1473.  
  1474.          You can insert text macros in any of these text strings. Also, a
  1475.          '|' (pipe symbol) will be replaced by a CR/LF. (Return/Linefeed)
  1476.  
  1477.  
  1478.  
  1479.         ┌──────────────────────────────────────────────────────────────────┐
  1480.         │ Site Info                                                        │
  1481.         └──────────────────────────────────────────────────────────────────┘
  1482.  
  1483.          System Name ................. The name of your BBS.  Will be
  1484.                                        written to EXITINFO.BBS.  Be sure
  1485.                                        this matches any "keys" you might
  1486.                                        have for any door programs.
  1487.  
  1488.          Sysop Name .................. The name of the Sysop.  This also
  1489.                                        will be written to EXITINFO.BBS
  1490.  
  1491.  
  1492.  
  1493.                                       - 26 -
  1494.  
  1495.  
  1496.  
  1497.          Default Origin Line ......... Default origin line, used for
  1498.                                        Echomail (more about this later).
  1499.  
  1500.          Number of Nodes ............. Used for multi-line systems.  Enter
  1501.                                        the maximum number of users allowed
  1502.                                        to log in at the same time (max. 255)
  1503.  
  1504.  
  1505.  
  1506.         ┌──────────────────────────────────────────────────────────────────┐
  1507.         │ Protocol Configuration - (F2)                                    │
  1508.         └──────────────────────────────────────────────────────────────────┘
  1509.  
  1510.          The second (POWERFUL) option in PROCFG.EXE is 'Protocols'. You may
  1511.          want to skip this option when doing a first-time installation of
  1512.          ProBoard, as many protocol configurations are included in the
  1513.          file PROTOCOL.PRO.  You should select each protocol listed and
  1514.          set 'Enabled' to 'No' (you won't lose the protocol configuration)
  1515.          unless you have the actual protocol file itself physically on your
  1516.          hard drive.  The protocols themselves are NOT included with
  1517.          ProBoard, but can be obtained from any ProBoard Support BBS, as
  1518.          well as many others.
  1519.  
  1520.          Downloading and uploading files has always been one of the most
  1521.          important activities of BBS's. Most BBS programs have file
  1522.          transfer protocols pre-installed and do not allow additional
  1523.          protocols to be configured.  ProBoard's philosophy is entirely
  1524.          different: no protocols are actually embedded in the code, all
  1525.          protocols are external and are being called by ProBoard.
  1526.  
  1527.          As of yet, we don't know of any external protocol incompatible
  1528.          with ProBoard, Bimodem included!  If you happen to find one that
  1529.          you think is an incompatible external file transfer protocol,
  1530.          please let us know!
  1531.  
  1532.          Upon selection of the 'Protocols' option, a submenu is displayed
  1533.          containing the protocols already present. Add a protocol by
  1534.          pressing <Ins>, remove a protocol by pressing <Del>.
  1535.  
  1536.  
  1537.          A protocol is entirely defined by the following parameters:
  1538.  
  1539.  
  1540.          Protocol Name ............... Protocol's name, to be displayed in
  1541.                                        the down/upload menu. This can
  1542.                                        include a short description if you
  1543.                                        like.
  1544.  
  1545.          Hotkey ...................... Key to be pressed by the user to
  1546.                                        activate the protocol.
  1547.  
  1548.  
  1549.                                       - 27 -
  1550.  
  1551.  
  1552.  
  1553.          Batch ....................... Determines whether the protocol can
  1554.                                        handle batch-mode (whether it can
  1555.                                        handle multiple files). Xmodem for
  1556.                                        example can handle only one file at a
  1557.                                        time, while Zmodem can handle
  1558.                                        multiple files.
  1559.  
  1560.          Enabled ..................... ProBoard comes with several pre-
  1561.                                        configured protocols for which you
  1562.                                        may not have the necessary files.
  1563.                                        It would be useless to have these
  1564.                                        protocols displayed in the menu. You
  1565.                                        can prevent this by setting Enable
  1566.                                        to 'No', without having to lose the
  1567.                                        configuration for this protocol.
  1568.  
  1569.          Both-Way .................... Determines whether the protocol is a
  1570.                                        full-duplex protocol, ie. whether it
  1571.                                        can send and receive files at the
  1572.                                        same time. (eg. Bimodem)
  1573.  
  1574.          Bimodem ..................... The Bimodem protocol uses an odd
  1575.                                        format for its control file. Setting
  1576.                                        Bimodem to 'Yes' causes the control
  1577.                                        file to be written to disk in
  1578.                                        Bimodem-format.
  1579.  
  1580.          Log File .................... Name of the log file created by the
  1581.                                        protocol. After the file transfer,
  1582.                                        the information needed to update the
  1583.                                        user-records will be obtained from
  1584.                                        this file by ProBoard. Most
  1585.                                        protocols write a file specified
  1586.                                        in the environment variable DSZLOG.
  1587.                                        ProBoard will set this variable to
  1588.                                        the right filename for you. ProBoard
  1589.                                        checks for the logfile in the
  1590.                                        directory where it was started from,
  1591.                                        so if some external protocol writes
  1592.                                        a different logfile than the one
  1593.                                        specified in the DSZLOG-variable,
  1594.                                        make sure it writes the file in the
  1595.                                        startup-directory!
  1596.  
  1597.  
  1598.  
  1599.  
  1600.  
  1601.  
  1602.  
  1603.  
  1604.  
  1605.                                       - 28 -
  1606.  
  1607.  
  1608.  
  1609.          Control File ................ Protocols that can handle batch-mode
  1610.                                        usually allow parameters to be
  1611.                                        passed not only on the command line,
  1612.                                        but also (should the command line
  1613.                                        grow too long) by means of a control
  1614.                                        file. ProBoard must know of this
  1615.                                        file, to be able to pass the file-
  1616.                                        names to the protocol.
  1617.  
  1618.          Download Command ............ Command needed to start the protocol
  1619.                                        in download-mode. You may want to
  1620.                                        use the shell options of menu
  1621.                                        function 7 here.
  1622.                                        If the first character of this
  1623.                                        command is a '@', the named pex-file
  1624.                                        will be run. Note that no shell
  1625.                                        parameters (*x) are supported when
  1626.                                        calling a pex-file. You can use
  1627.                                        string macros though.
  1628.  
  1629.                                        IMPORTANT: The command should be in-
  1630.                                                   dependent of the path it
  1631.                                                   is called from.
  1632.  
  1633.                                        Batch-mode protocols also require a
  1634.                                        control file to be specified. Should
  1635.                                        you, anywhere in this field, fill in
  1636.                                        a '#', then this character will at
  1637.                                        run-time be replaced by the filename
  1638.                                        of the file to be sent (only for
  1639.                                        non-batch protocols).
  1640.  
  1641.          Upload Command .............. Command needed to start the protocol
  1642.                                        in upload-mode. Here also, the
  1643.                                        command should be independent of the
  1644.                                        directory it is called from and a
  1645.                                        '#' will be replaced by the filename
  1646.                                        of the file to be received (for
  1647.                                        non-batch protocols), or by the
  1648.                                        directory where files should be
  1649.                                        received into (for batch-protocols).
  1650.                                        A '@' as the first character will
  1651.                                        execute a pex-file (see DL Command).
  1652.  
  1653.  
  1654.  
  1655.  
  1656.  
  1657.  
  1658.  
  1659.  
  1660.  
  1661.                                       - 29 -
  1662.  
  1663.  
  1664.  
  1665.          Download String ............. Determines what should be written in
  1666.                                        the control file when downloading.
  1667.                                        A '#' character is replaced by the
  1668.                                        path and filename of the file to
  1669.                                        be sent to the user. Most often, a
  1670.                                        single '#' is the only character in
  1671.                                        this field. This works for most of
  1672.                                        the protocols.
  1673.  
  1674.                                        Example:
  1675.  
  1676.                                        In case a user wants to download 3
  1677.                                        files, entering 'Send #' in this
  1678.                                        field causes the following to be
  1679.                                        written in the control file:
  1680.  
  1681.                                             Send C:\PB\FILES\COMM\TM.ARJ
  1682.                                             Send C:\PB\FILES\COMM\TBILL.ARJ
  1683.                                             Send C:\PB\FILES\UTIL\SHEZ55.ARJ
  1684.  
  1685.                                        You can always take a look at the
  1686.                                        pre-configured protocols, to lighten
  1687.                                        things up for you.
  1688.  
  1689.          Upload String ............... <reserved for future use>
  1690.  
  1691.          Download Keyword ............ In order to allow ProBoard to update
  1692.                                        the user-records from the protocol's
  1693.                                        log file, a keyword must be
  1694.                                        specified to indicate a file has
  1695.                                        successfully been sent. If a protocol
  1696.                                        writes 'Sent <filename>' in the
  1697.                                        logfile, you should specify 'Sent'
  1698.                                        as the keyword. This keyword is CASE
  1699.                                        SENSITIVE!
  1700.  
  1701.          Upload Keyword .............. Same as the previous field, for
  1702.                                        uploads.
  1703.  
  1704.  
  1705.  
  1706.  
  1707.  
  1708.  
  1709.  
  1710.  
  1711.  
  1712.  
  1713.  
  1714.  
  1715.  
  1716.  
  1717.                                       - 30 -
  1718.  
  1719.  
  1720.  
  1721.          File Word Number............. This is the number of the sent file's
  1722.                                        filename, counting from the keyword,
  1723.                                        but NOT including the keyword. This
  1724.                                        is used for both uploads and
  1725.                                        downloads.
  1726.  
  1727.                                        Eg. Sent 12/05/90 12334 PB_100.ARJ
  1728.  
  1729.                                        In this case, you should enter '3'
  1730.                                        as the word number, because
  1731.                                        PB_100.ARJ is the third word counting
  1732.                                        from, but not including, the
  1733.                                        keyword ('Sent').
  1734.  
  1735.          Efficiency .................. A percentage that gives the
  1736.                                        throughput efficiency for this
  1737.                                        protocol. This value is used to
  1738.                                        estimate the time needed to perform
  1739.                                        a file transfer.
  1740.  
  1741.          CONCLUSION:
  1742.  
  1743.          Correctly installing the protocols may seem somewhat difficult at
  1744.          first, but you will soon get used to it. And don't forget that the
  1745.          most popular protocols are already pre-configured in ProBoard!
  1746.  
  1747.  
  1748.  
  1749.         ┌──────────────────────────────────────────────────────────────────┐
  1750.         │ Message Areas - (F3)                                             │
  1751.         └──────────────────────────────────────────────────────────────────┘
  1752.  
  1753.          ProBoard can have up to 200 different message areas. Each message
  1754.          area has its own name and properties.  For example, you could have
  1755.          message areas for public messages only, message areas for Echomail,
  1756.          or an area to create "Announcements" for your users.
  1757.  
  1758.          You can configure all of this with the ProBoard message area
  1759.          editor.
  1760.  
  1761.          Selecting 'Message Areas' from the Main Menu, gives you a list of
  1762.          the available areas (which initially is empty of course,). You
  1763.          edit a Message Area by pressing [Enter].
  1764.  
  1765.          The ProBoard message base is capable of holding approx. 32,000
  1766.          messages.  However, due to the limitations of the Hudson style
  1767.          message base, you should not let your message base exceed 16
  1768.          megabytes in size.
  1769.  
  1770.  
  1771.  
  1772.  
  1773.                                       - 31 -
  1774.  
  1775.  
  1776.  
  1777.          A message area has the following fields:
  1778.  
  1779.  
  1780.          Name ........................ Name of this message area.
  1781.  
  1782.          Message kind ................ The kind of message. You can have:
  1783.  
  1784.                                          - Local          Local messages
  1785.                                          - EchoMail       Echomail
  1786.                                          - NetMail        Netmail
  1787.                                          - Pvt EchoMail   Private Echomail
  1788.  
  1789.                                        One word about the difference between
  1790.                                        the "Echo" type and the "Pvt Echo"
  1791.                                        type: In "Echo" areas, it is not
  1792.                                        allowed to delete messages that have
  1793.                                        been exported by an echomail
  1794.                                        processor (as specified by the FTSC,
  1795.                                        the FidoNet Technical Standards
  1796.                                        Committee). In a "Pvt Echo" area, this
  1797.                                        restriction is not imposed.
  1798.  
  1799.          Message Type ................ One of the following:
  1800.  
  1801.                                        - Private only  Only private
  1802.                                                        messages allowed.
  1803.  
  1804.                                        - Pvt/Public    Private or public
  1805.                                                        messages allowed.
  1806.  
  1807.                                        - Public only   Only public
  1808.                                                        messages allowed.
  1809.  
  1810.                                        - To All        This message type
  1811.                                                        should be used in
  1812.                                        a LOCAL message area only.  It is
  1813.                                        intended for a Sysop to leave
  1814.                                        messages to all users.  Any messages
  1815.                                        entered in this area will considered
  1816.                                        "To All" regardless of the whom the
  1817.                                        "To" is addressed to. Messages entered
  1818.                                        in this area will be shown when
  1819.                                        ProBoard checks for waiting mail.
  1820.  
  1821.                                        You should not allow users to reply
  1822.                                        to these messages since their replies
  1823.                                        will be sent to all users.  Instead,
  1824.                                        set the reply area to a different
  1825.                                        area.
  1826.  
  1827.  
  1828.  
  1829.                                       - 32 -
  1830.  
  1831.  
  1832.  
  1833.          Name Options ................ Determines which names can be used
  1834.                                        to write messages in this area. This
  1835.                                        can be:
  1836.  
  1837.                                            - Real Names Only
  1838.                                            - Free Alias
  1839.                                            - Fixed Alias
  1840.  
  1841.                                        It is recommended that areas where
  1842.                                        aliases are allowed, are made
  1843.                                        "Public Only".
  1844.  
  1845.          Read Level .................. Level needed to read messages in
  1846.                                        this area.
  1847.  
  1848.          Read Flags .................. Flags needed to read messages in
  1849.                                        this area.
  1850.  
  1851.          Write Level ................. Level needed to write messages in
  1852.                                        this area.
  1853.  
  1854.          Write Flags ................. Flags needed to write messages in
  1855.                                        this area.
  1856.  
  1857.          Sysop Level ................. Level needed to be allowed EVERYTHING
  1858.                                        in this message area.
  1859.  
  1860.          Sysop Flags ................. Flags needed to be allowed EVERYTHING
  1861.                                        in this message area.
  1862.  
  1863.          Origin Line ................. Only for Echomail: if you do not
  1864.                                        specify this, the default origin
  1865.                                        line will be used (refer to F1 - Site
  1866.                                        Options)
  1867.  
  1868.          Use AKA ..................... The network address for this area
  1869.                                        (for Echomail & Netmail only).
  1870.  
  1871.          Reply Area .................. The area where replies to messages in
  1872.                                        this area should be posted.  Useful for
  1873.                                        allowing users to reply to "To-All"
  1874.                                        messages.  Set this to "0" (zero) if
  1875.                                        you want replies to go to this area.
  1876.  
  1877.          Sysop ....................... The user name for an "Area Sysop".
  1878.                                        A user with this name will have full
  1879.                                        Sysop access to this message area.
  1880.                                        When users write messages to "Sysop"
  1881.                                        in this area, the messages will be
  1882.                                        sent to the user name specified here.
  1883.  
  1884.  
  1885.                                       - 33 -
  1886.  
  1887.  
  1888.  
  1889.          Kill after <xx> days ........ When running the PBUtil message-
  1890.                                        packer with the -D parameter, all
  1891.                                        messages that have been in the
  1892.                                        messagebase for <xx> days will be
  1893.                                        deleted.
  1894.  
  1895.          Kill rcvd after <xx> days ... When running the PBUtil message-
  1896.                                        packer with the -D parameter, all
  1897.                                        messages that have been received for
  1898.                                        xx days will be deleted.
  1899.  
  1900.          Max # messages .............. The maximum number of messages
  1901.                                        allowed in this area. When this
  1902.                                        number is exceeded, PBUTIL MP -D
  1903.                                        (message pack & delete) will delete
  1904.                                        the oldest messages from the
  1905.                                        messagebase.
  1906.  
  1907.  
  1908.  
  1909.         ┌──────────────────────────────────────────────────────────────────┐
  1910.         │ File areas - (F4)                                                │
  1911.         └──────────────────────────────────────────────────────────────────┘
  1912.  
  1913.          File areas are used to categorize downloadable files. You can even
  1914.          prevent groups of users to access certain file areas.
  1915.  
  1916.          A file area has the following fields:
  1917.  
  1918.  
  1919.          Area Name ................... Name of this file area.  Displayed
  1920.                                        to users on the BBS.
  1921.  
  1922.          Listing File ................ Full path & filename of the file in
  1923.                                        which the downloadable files are
  1924.                                        described.  Refer to Menu Function
  1925.                                        31, in the chapter on Menus.
  1926.  
  1927.                                        Sample: C:\PB\DLOAD\FILES.BBS)
  1928.  
  1929.  
  1930.  
  1931.  
  1932.  
  1933.  
  1934.  
  1935.  
  1936.  
  1937.  
  1938.  
  1939.  
  1940.  
  1941.                                       - 34 -
  1942.  
  1943.  
  1944.  
  1945.          File Location ............... Directory where the files for this
  1946.                                        area are located.  It is also possible
  1947.                                        to specify multiple directories per file
  1948.                                        area.  To do this, enter the first file
  1949.                                        directory here, then create a file in
  1950.                                        the ProBoard system directory (usually
  1951.                                        C:\PB) called FA_<area>.CTL.  Place
  1952.                                        each additional file directory (one
  1953.                                        directory per line) in this file to
  1954.                                        tell ProBoard where to find the
  1955.                                        additional directories for this file
  1956.                                        area.
  1957.  
  1958.                                        Example:  for file area #10 (Games),
  1959.                                        which has a total of 4 directories,
  1960.                                        place the first directory in the "File
  1961.                                        Location" slot in PROCFG, then create a
  1962.                                        file called FA_10.CTL. In this file,
  1963.                                        place the additional directories one
  1964.                                        per line like this:
  1965.  
  1966.                                        D:\DLOAD\GAMES2
  1967.                                        D:\DLOAD\GAMES3
  1968.                                        D:\DLOAD\GAMES4
  1969.  
  1970.                                        Use an ascii editor like QEDIT to
  1971.                                        create this file.
  1972.  
  1973.          Access Flags ................ Flags needed to download files in
  1974.                                        this area.
  1975.  
  1976.          Access Level ................ Level needed to download files in
  1977.                                        this area.
  1978.  
  1979.          CD-ROM Option ............... Setting this option to 'Yes' makes
  1980.                                        the file listings look somewhat
  1981.                                        different. Refer to Menu Function
  1982.                                        31, "List Files".
  1983.  
  1984.          In TOPFILES.................. Determines whether or not this file
  1985.                                        area is included when TOPFILES.A??
  1986.                                        is created.  Refer to PBUTIL FC for
  1987.                                        more information.
  1988.  
  1989.          Free Area ................... Specifies whether or not ALL files
  1990.                                        in this file area are FREE files.
  1991.                                        If this is set to 'Yes', any files
  1992.                                        a user downloads from this area will
  1993.                                        not be deducted from their download
  1994.                                        limits.
  1995.  
  1996.  
  1997.                                       - 35 -
  1998.  
  1999.  
  2000.  
  2001.          Max. files................... Maximum number of files that can be
  2002.                                        downloaded from this area per
  2003.                                        user per day (0 means unlimited).
  2004.  
  2005.          Max. Kb...................... Maximum number of Kbytes that can be
  2006.                                        downloaded from this area per
  2007.                                        user per day (0 means unlimited).
  2008.  
  2009.  
  2010.  
  2011.         ┌──────────────────────────────────────────────────────────────────┐
  2012.         │ Time/Download Limits  - (F5)                                     │
  2013.         └──────────────────────────────────────────────────────────────────┘
  2014.  
  2015.          In ProBoard you can grant different groups of users different
  2016.          rights concerning download-limits and maximum online time per day.
  2017.          Additionally, you can limit downloading in a very powerful and
  2018.          flexible way.
  2019.  
  2020.          Editing user levels is done in by pressing <Ins>,<Del>, and <Enter>.
  2021.  
  2022.          These are the fields to be specified for each level:
  2023.  
  2024.  
  2025.          Security Level .............. The userlevel you are editing.
  2026.  
  2027.          Time Per Day ................ Time a user with this level can
  2028.                                        spend on your system each day.
  2029.  
  2030.          Kb Download Per Day ......... Daily download-limit associated with
  2031.                                        this user level (in Kbytes/day).
  2032.  
  2033.          Download Delay .............. Time to be spent per session before
  2034.                                        a download can be made (great to
  2035.                                        calm down excessive downloaders).
  2036.  
  2037.          Usergroup ID ................ String of max. 5 characters that
  2038.                                        identifies this level, eg. NEW,
  2039.                                        REG, VIP. This is optional.
  2040.                                        These ID's will be shown when the
  2041.                                        userlist is displayed (Refer to
  2042.                                        Menu Function 13).
  2043.  
  2044.          Free Download ............... The amount that can be downloaded
  2045.                                        by users with this level, without
  2046.                                        having to upload or write messages.
  2047.  
  2048.  
  2049.  
  2050.  
  2051.  
  2052.  
  2053.                                       - 36 -
  2054.  
  2055.  
  2056.  
  2057.          Upload Needed ............... The percentage of total downloads
  2058.                                        the user has to upload.
  2059.                                        Eg. if the upload factor is 15%, and
  2060.                                        a user has downloaded 1000Kb, he
  2061.                                        will have to upload 150Kb.
  2062.                                        Setting this to 0 allows the users
  2063.                                        to download as much as they want,
  2064.                                        until the download limit (see below)
  2065.                                        is reached. Of course, it is
  2066.                                        impossible to download more than the
  2067.                                        daily maximum each day.
  2068.  
  2069.          Free Download/Msg ........... The amount of Kilobytes that can be
  2070.                                        downloaded free for each message
  2071.                                        written. This rewards busy message-
  2072.                                        writers by increasing their download-
  2073.                                        limit. The amount of kilobytes is
  2074.                                        added to the free download number
  2075.                                        (see above)
  2076.  
  2077.          Maximum Download ............ When this limit is set to a positive
  2078.                                        non-zero value, and a user reaches
  2079.                                        this limit, his/her level will be
  2080.                                        changed to the "Fall To" level.
  2081.  
  2082.  
  2083.          Fall To Level ............... Security Level user should be assigned
  2084.                                        when their "Maximum Download" (above)
  2085.                                        is reached.
  2086.  
  2087.  
  2088.  
  2089.         ┌──────────────────────────────────────────────────────────────────┐
  2090.         │ User Editor (F6)                                                 │
  2091.         └──────────────────────────────────────────────────────────────────┘
  2092.  
  2093.          Working with the user editor is easy. You can use the user
  2094.          editor to search for, look at, and change a user's data. You
  2095.          can edit users with the PROCFG utility.  The editor activated by
  2096.          Alt-E in ProBoard is identical to the one in PROCFG.
  2097.  
  2098.          You can use the following keys in the user editor:
  2099.  
  2100.              <PgUp>          Go to the previous user-record.
  2101.              <PgDn>          Go to the next user-record.
  2102.  
  2103.              <Ctrl-PgUp>     Go to the first user-record.
  2104.              <Ctrl-PgDn>     Go to the last user-record.
  2105.  
  2106.  
  2107.  
  2108.  
  2109.                                       - 37 -
  2110.  
  2111.  
  2112.  
  2113.              <Alt-S>         Search for a user-record. You may specify
  2114.                              whole or part of a user's name.
  2115.  
  2116.              <Alt-N>         Search for the next user-record complying to
  2117.                              the name specified with <Alt-S>.
  2118.  
  2119.              <Alt-D>         Toggle the 'deleted' flag of the current user.
  2120.  
  2121.              <Alt-A>         Add a new user
  2122.  
  2123.              <F10>           Opens a secondary window containing additional
  2124.                              information about the current user.  Once this
  2125.                              window is displayed, you may display/edit the
  2126.                              following items.
  2127.  
  2128.                                 - Times Called.
  2129.                                 - Total Number of Downloads.
  2130.                                 - Total KB of Downloads.
  2131.                                 - Total Number of Uploads.
  2132.                                 - Total KB of Uploads.
  2133.                                 - Number of Messages User has posted.
  2134.                                 - Total Time user has spent online to date.
  2135.                                 - Total KB downloaded today.
  2136.  
  2137.          When you have found the user-record you were looking for, move
  2138.          between the fields by using the arrow keys. To edit a field, just
  2139.          move the selector to that field and begin editing straight away
  2140.          (Insert is ALWAYS on).
  2141.  
  2142.  
  2143.          A user-record has the following fields:
  2144.  
  2145.              User Name ............ User's name.
  2146.  
  2147.              Password ............. User's password.
  2148.  
  2149.              City ................. City the user lives in.
  2150.  
  2151.              Country .............. Country (or state) the user lives in.
  2152.  
  2153.              Voice Phone # ........ User's voice phone number (not
  2154.                                     restricted to a certain layout).
  2155.                                     Europeans hate the restrictions in
  2156.                                     other BBS packages :-(
  2157.  
  2158.              Data/Fax Phone # ..... User's data or fax number (if any).
  2159.  
  2160.              Level ................ User's level (ranging from 0 to 64000).
  2161.                                     A 0 means that the user has NO access
  2162.                                     to the BBS.
  2163.  
  2164.  
  2165.                                       - 38 -
  2166.  
  2167.  
  2168.  
  2169.              Flags ................ User's flags. Edit them by pressing
  2170.                                     <Enter>, and then pressing any
  2171.                                     character ranging from A - Z and
  2172.                                     1 - 6 to toggle that flag.
  2173.  
  2174.              Loglevel ............. The way in which the user will be
  2175.                                     logged in the logfile (more about this
  2176.                                     later).
  2177.  
  2178.              Alias ................ Each user can have a unique 'alias'
  2179.                                     (nickname). In selected message areas,
  2180.                                     the user can use this alias to write
  2181.                                     messages or (if enabled) can login
  2182.                                     using this alias.
  2183.  
  2184.              Netmail credit ....... Number of credits the user has left to
  2185.                                     write Netmail messages.
  2186.  
  2187.              Screen Length ........ number of screen lines for this user.
  2188.  
  2189.              Expiration Date ...... When this date is specified (non-zero),
  2190.                                     the user's security level will drop to
  2191.                                     the level specified in the Expiration
  2192.                                     Level field (below).
  2193.  
  2194.              Expiration level ..... The new security level assigned to a
  2195.                                     user when the expiration date (if other
  2196.                                     than 0) is reached.
  2197.  
  2198.              Comment .............. This field allows you to enter comments
  2199.                                     about this particular user.
  2200.  
  2201.              Birth Date ........... The date of birth of this user.
  2202.  
  2203.              First Call ........... The date of the user's first call to
  2204.                                     the system.
  2205.  
  2206.              Hidden ............... If enabled, ProBoard will hide this
  2207.                                     users activity from the Last Callers
  2208.                                     list (Function 51), Show Users Online
  2209.                                     (Function 50), and from the display of
  2210.                                     the User List (Function 13).
  2211.  
  2212.              Deleted .............. If a user is set to deleted, his record
  2213.                                     will be removed from USERS.BBS upon the
  2214.                                     next user pack.
  2215.  
  2216.              ANSI ................. Should ANSI codes be sent to the user?
  2217.  
  2218.              AVATAR ............... Should AVATAR codes be sent to the user?
  2219.  
  2220.  
  2221.                                       - 39 -
  2222.  
  2223.  
  2224.  
  2225.              More Prompt .......... Pause after each screen?
  2226.  
  2227.              Clear Screen ......... Send screen clearing codes to the user?
  2228.  
  2229.              Stacking ............. Use command-stacking/hot keys (toggle).
  2230.  
  2231.              No-IBM ............... Determines whether all the IBM-specific
  2232.                                     characters should be filtered out and
  2233.                                     converted to standard ASCII.
  2234.  
  2235.              Full Screen Editor ... Use the fullscreen message editor or
  2236.                                     the internal line editor?
  2237.  
  2238.              NoKill ............... The user's record CAN NEVER be removed
  2239.                                     from the userfile.
  2240.  
  2241.              Ignore Download ...... Does the user have UNLIMITED download
  2242.                                     access?
  2243.  
  2244.              Attention ............ ProBoard will beep or play a song when
  2245.                                     this user tries to log in.
  2246.  
  2247.              In Tops .............. If enabled, this user will be shown in
  2248.                                     'tops' lists (Menu Function 48)
  2249.  
  2250.  
  2251.  
  2252.         ┌──────────────────────────────────────────────────────────────────┐
  2253.         │ Menu Editor (F7)                                                 │
  2254.         └──────────────────────────────────────────────────────────────────┘
  2255.  
  2256.          Creating Menus for ProBoard is extremely easy using the built-in
  2257.          Menu Editor.  Basically, each line of your menus that your users
  2258.          will see contains the following attributes.
  2259.  
  2260.          Text Line ................... Text line to be displayed to the
  2261.                                        user.
  2262.  
  2263.          HotKey ...................... The key the user is to press to
  2264.                                        activate this menu option.
  2265.  
  2266.          Function .................... Function to be executed.
  2267.  
  2268.          Data ........................ Data associated with this menu item.
  2269.  
  2270.          Level ....................... Security level users needs to access
  2271.                                        this menu item.
  2272.  
  2273.          Flags ....................... The flags that the user needs in their
  2274.                                        user record to access this menu item.
  2275.  
  2276.  
  2277.                                       - 40 -
  2278.  
  2279.  
  2280.  
  2281.          Color ....................... Color of this menu item.
  2282.  
  2283.          When you select the 'Menu Editor' option in PROCFG's main menu, a
  2284.          new window will be opened containing the menus already available.
  2285.  
  2286.          In this window, you can use the following keys:
  2287.  
  2288.            - Up/Down       Scroll up/down.
  2289.            - Enter         Select a menu.
  2290.            - Ins           Add a menu.
  2291.  
  2292.          When you have selected a menu, a list of all the menu items will
  2293.          be displayed. To add a menu item, just move past the last item and
  2294.          press <Enter>. To insert an item, press <Ins>, to remove one,
  2295.          press <Del>. To edit a menu item, move the selector to that item
  2296.          and press <Enter>. You can change the menu prompt and highlight
  2297.          colors by pressing <Alt-P>. If you want to see how a menu will look
  2298.          like, press <Alt-S>. You can also copy and paste menu items. To copy
  2299.          an item, move to the item you want to copy, and press <Alt-C>. To
  2300.          insert the copied item somewhere else, move to the place where you
  2301.          want the menu item, and press <Ctrl-P>. You can even copy and paste
  2302.          items across different menus.
  2303.  
  2304.  
  2305.  
  2306.         ┌──────────────────────────────────────────────────────────────────┐
  2307.         │ Matrix Addresses (F8)                                            │
  2308.         └──────────────────────────────────────────────────────────────────┘
  2309.  
  2310.  
  2311.          This is where you enter your net address.  If you have more than
  2312.          one net address, enter them here also.
  2313.  
  2314.  
  2315.  
  2316.         ┌──────────────────────────────────────────────────────────────────┐
  2317.         │ Modem Parameters - (F9)                                          │
  2318.         └──────────────────────────────────────────────────────────────────┘
  2319.  
  2320.          You don't have to change these parameters when using ProBoard with
  2321.          a mailer. Should ProBoard, however, need to answer the phone, you
  2322.          may want to take a look at (and change) these parameters.
  2323.  
  2324.  
  2325.  
  2326.  
  2327.  
  2328.  
  2329.  
  2330.  
  2331.  
  2332.  
  2333.                                       - 41 -
  2334.  
  2335.  
  2336.  
  2337.          You can insert special codes in the modem command strings:
  2338.  
  2339.              ^        Set DTR high.
  2340.              ` or v   Set DTR low.
  2341.              |        Sends a <CR> to the modem.
  2342.              $        Sends a break to the modem.
  2343.              ~        Pauses for 1/2 second.
  2344.  
  2345.  
  2346.          Max. Baud Rate .............. Maximum baud rate your modem can
  2347.                                        handle.
  2348.  
  2349.          Com-port .................... Number of the com-port the modem is
  2350.                                        connected to (1-8).
  2351.  
  2352.          Blanktime (s) ............... Time after which the (YOUR) screen
  2353.                                        goes blank, to prevent burn-in.
  2354.  
  2355.          Modem Delay ................. Number of 1/10 seconds to pause
  2356.                                        between each character that is sent
  2357.                                        to the modem (some modems can't
  2358.                                        handle FAST input).
  2359.  
  2360.          Init String ................. String to be sent to the modem to
  2361.                                        initialize it and to have the modem
  2362.                                        ready to answer the phone.
  2363.                                        You can use text macros in this
  2364.                                        string. This can be useful for
  2365.                                        specifying a different init string
  2366.                                        for each node.
  2367.  
  2368.          Init Response ............... String returned by the modem if the
  2369.                                        initialization was successful.
  2370.  
  2371.          Busy String ................. String to be sent to the modem when
  2372.                                        the BBS is off-line (because Sysop
  2373.                                        pressed <Esc> or is logging in
  2374.                                        locally).
  2375.  
  2376.          Manual Answer ............... If enabled, ProBoard will answer
  2377.                                        the phone manually by sending the
  2378.                                        answer string when the ring string
  2379.                                        is received. Do NOT set your modem
  2380.                                        in auto-answer mode when using this
  2381.                                        option.
  2382.  
  2383.          RING String ................. The string the modem sends to
  2384.                                        ProBoard when a call is coming in.
  2385.                                        Usually, this is set to "RING".
  2386.  
  2387.  
  2388.  
  2389.                                       - 42 -
  2390.  
  2391.  
  2392.  
  2393.          Answer String ............... The command ProBoard sends to the
  2394.                                        modem to answer the phone. Usually,
  2395.                                        this is set to "ATA".
  2396.  
  2397.          XXX Bps Call ................ String returned by the modem upon an
  2398.                                        XXX bps call. This is a 'partial'
  2399.                                        string. So if the modem sends
  2400.                                        'CONNECT 2400/ARQ', the string
  2401.                                        'CONNECT 2400' will match.
  2402.                                        A '|' can be used to specify a CR.
  2403.                                        It HAS to be used for the 300 bps
  2404.                                        connect string, because "CONNECT"
  2405.                                        without a '|' would match "CONNECT
  2406.                                        2400" or "CONNECT 9600". So the
  2407.                                        correct string is: "CONNECT|".
  2408.  
  2409.  
  2410.  
  2411.          LOCKING BAUD RATES
  2412.          ──────────────────
  2413.  
  2414.          Note: If you use an error-correcting modem (MNP/V42), you have to
  2415.                lock your serial port speed.
  2416.  
  2417.          A "locked" baud rate refers to the tranfer rate between the
  2418.          computer and modem.  When locked, the baud rate will remain
  2419.          constant regardless of what the application program, such as
  2420.          ProBoard, requests the baud rate to be.  The modem MUST support
  2421.          a constant computer to modem speed, otherwise any baud rate change
  2422.          requested by an application will be ignored, resulting in an
  2423.          incorrect setting between your system and your users.  The result
  2424.          will be garbled input and output.
  2425.  
  2426.          Most high speed modems do support a fixed baud rate, and by locking
  2427.          the baud rate you will obtain higher throughput.  A fossil program
  2428.          like X00 or BNU will handle this for you and is HIGHLY RECOMMENDED
  2429.          (see the respective fossil doc file for command syntax).
  2430.  
  2431.          Note:  Experience shows that a faster locking baud rate than actual
  2432.          phone line baud rate will yield the best results.
  2433.  
  2434.  
  2435.                 Examples:  X00 B,0,9600
  2436.                            BNU /L0=9600
  2437.  
  2438.           See your FOSSIL documentation for details.  If possible, install
  2439.           your fossil for "quiet" or "no commercial" mode so the screen
  2440.           display from the fossil does not bleed onto the ProBoard main
  2441.           screen (stand-alone systems with no mailers in particular).
  2442.  
  2443.  
  2444.  
  2445.                                       - 43 -
  2446.  
  2447.  
  2448.  
  2449.         ┌──────────────────────────────────────────────────────────────────┐
  2450.         │ Events - (Shift-F1)                                              │
  2451.         └──────────────────────────────────────────────────────────────────┘
  2452.  
  2453.          It is possible to instruct ProBoard to perform some action at a
  2454.          set time and day (an "Event"). This action can be: exiting with
  2455.          a specific errorlevel (for a batch file) or executing a DOS
  2456.          command.  This is useful for example, to pack the user file, or to
  2457.          pack the message base at a specified time each day.
  2458.  
  2459.          You can define up to 30 events. An event is described by the
  2460.          following fields:
  2461.  
  2462.  
  2463.          Enabled...................... If this is set to 'No', the event
  2464.                                        will be ignored.
  2465.  
  2466.          Active Days.................. Determines on what days of the week
  2467.                                        this event will run. To edit this
  2468.                                        field, press <Enter> and toggle
  2469.                                        the 'Yes/No' fields displayed next
  2470.                                        to each day.
  2471.  
  2472.          Event Time................... The time at which the event has to
  2473.                                        run on the selected days (in 24h
  2474.                                        format).
  2475.  
  2476.          Duration..................... How long this event has to stay
  2477.                                        active. During the event, no users
  2478.                                        are allowed to log in on ANY node.
  2479.  
  2480.          Event type................... 'Command' : A DOS-command will be
  2481.                                                    executed when the event
  2482.                                                    is activated. You can
  2483.                                                    use any of the shell
  2484.                                                    options from menu type
  2485.                                                    7. Remember to use the
  2486.                                                    *Z option to run a batch
  2487.                                                    file.
  2488.  
  2489.                                        'Errlevel': When the event
  2490.                                                    is activated, ProBoard
  2491.                                                    will exit with an
  2492.                                                    errorlevel, specified in
  2493.                                                    the next field.
  2494.  
  2495.          Errorlevel................... The errorlevel to use for this event
  2496.                                        if the event type is set to
  2497.                                        'Errorlevel'.
  2498.  
  2499.  
  2500.  
  2501.                                       - 44 -
  2502.  
  2503.  
  2504.  
  2505.          DOS-command.................. The DOS-command to execute for this
  2506.                                        event if the event type is set to
  2507.                                        'Command'.
  2508.  
  2509.          Node number.................. An event will run on ONE node. You
  2510.                                        can specify the node here.
  2511.  
  2512.  
  2513.          When using a frontend-mailer, you only have to specify the time,
  2514.          days and duration, because the events have to be executed by the
  2515.          mailer.
  2516.  
  2517.  
  2518.  
  2519.         ┌──────────────────────────────────────────────────────────────────┐
  2520.         │ Personal Files - (Shift-F2)                                      │
  2521.         └──────────────────────────────────────────────────────────────────┘
  2522.  
  2523.          ProBoard allows you and other users to send "Personal Files" to
  2524.          each other on the BBS.  ProBoard keeps track of each uploaded file.
  2525.          You add/edit/delete them with this option in ProCFG.  In the list
  2526.          of files, a [+] means that the file physically exists in the
  2527.          private upload directory (the path you set in your configuration).
  2528.  
  2529.          To edit an entry, press <Enter>, to Delete an entry, press <Del>,
  2530.          and to add an entry, press <Ins>.
  2531.  
  2532.  
  2533.          Filename..................... Name of the uploaded file.
  2534.  
  2535.          From User.................... Who uploaded this file?
  2536.  
  2537.          To user...................... The destination user of this file.
  2538.  
  2539.          Date......................... The date on which this file was
  2540.                                        uploaded.
  2541.  
  2542.  
  2543.          It is possible to add files to this list.  This way you can send a
  2544.          file to a specific user.  Deleting files is possible too. If the
  2545.          file specified in the entry to be deleted physically exists,
  2546.          you will be asked if you want to delete the file on disk.
  2547.  
  2548.          For more information on how to implement this option on your BBS,
  2549.          refer to Menu Function(s) 22, 33, 32 explained in detail in the
  2550.          section on menus.
  2551.  
  2552.  
  2553.  
  2554.  
  2555.  
  2556.  
  2557.                                       - 45 -
  2558.  
  2559.  
  2560.  
  2561.         ┌───────────────────────────────────────────────────────────────────┐
  2562.         │ Edit Statistics (Shift-F3)                                        │
  2563.         └───────────────────────────────────────────────────────────────────┘
  2564.  
  2565.  
  2566.          Hourly Statistics ............ Pressing <ENTER> will display a
  2567.                                         window with the hours that are
  2568.                                         displayed on your system usage graph.
  2569.                                         You can edit them so your hourly
  2570.                                         graph looks different.
  2571.  
  2572.          Weekly Statistics ............ Pressing <ENTER> will display a
  2573.                                         window with the weekly information
  2574.                                         that is displayed on your system
  2575.                                         usage graph. You can edit this info
  2576.                                         so your weekly graph looks different.
  2577.  
  2578.  
  2579.  
  2580.  
  2581.  
  2582.  
  2583.  
  2584.  
  2585.  
  2586.  
  2587.  
  2588.  
  2589.  
  2590.  
  2591.  
  2592.  
  2593.  
  2594.  
  2595.  
  2596.  
  2597.  
  2598.  
  2599.  
  2600.  
  2601.  
  2602.  
  2603.  
  2604.  
  2605.  
  2606.  
  2607.  
  2608.  
  2609.  
  2610.  
  2611.  
  2612.  
  2613.                                       - 46 -
  2614.  
  2615.  
  2616.  
  2617.         ╒═══════════════════════════════════════════════════════════════════╕
  2618.         │ ░░░░░░ SECURITY ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  2619.         ╘═══════════════════════════════════════════════════════════════════╛
  2620.  
  2621.  
  2622.         ┌──────────────────────────────────────────────────────────────────┐
  2623.         │ Levels & Flags                                                   │
  2624.         └──────────────────────────────────────────────────────────────────┘
  2625.  
  2626.          All security procedures toward a user are being done through the
  2627.          user's LEVEL and FLAGS. ProBoard can have levels ranging from 0 to
  2628.          64000, and provides 32 flags (A-Z, and 1-6) that can be ON or OFF.
  2629.  
  2630.          If a menu needs a certain level and flags, then only the users with
  2631.          a level equal to or higher than that level and with all the needed
  2632.          flags will be able to SEE and CHOOSE this menu option. It will
  2633.          remain invisible to all the other users.
  2634.  
  2635.          An example will be given in the next chapter.
  2636.  
  2637.  
  2638.  
  2639.         ┌──────────────────────────────────────────────────────────────────┐
  2640.         │ Trashcan                                                         │
  2641.         └──────────────────────────────────────────────────────────────────┘
  2642.  
  2643.          It is possible to specify names that cannot be used to log on to
  2644.          your system. Often used fake names are: "Sysop", "BBS", etc...
  2645.  
  2646.          You can specify these names in a textfile called TRASHCAN.CTL.
  2647.          Each line in this file specifies an unwanted or illegal name.
  2648.  
  2649.          An example file is included.
  2650.  
  2651.  
  2652.  
  2653.  
  2654.  
  2655.  
  2656.  
  2657.  
  2658.  
  2659.  
  2660.  
  2661.  
  2662.  
  2663.  
  2664.  
  2665.  
  2666.  
  2667.  
  2668.  
  2669.                                       - 47 -
  2670.  
  2671.  
  2672.  
  2673.         ┌──────────────────────────────────────────────────────────────────┐
  2674.         │░░░░░░ MENUS ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  2675.         └──────────────────────────────────────────────────────────────────┘
  2676.  
  2677.  
  2678.          This is the most important part of a BBS, and therefore of
  2679.          ProBoard.  Menus are the direct interface between a user and your
  2680.          BBS. They are used to execute all the BBS functions, and they can
  2681.          have their own submenus. They take care of security, by disabling
  2682.          or hiding certain functions from certain users or groups of users.
  2683.          ProBoard can make your BBS have a very personal look, as the menus
  2684.          can be built/displayed in a VERY flexible way.
  2685.  
  2686.  
  2687.  
  2688.         ┌──────────────────────────────────────────────────────────────────┐
  2689.         │ Setting Up Menus                                                 │
  2690.         └──────────────────────────────────────────────────────────────────┘
  2691.  
  2692.          A menu is basically line-oriented. Every line is linked to a
  2693.          function to be executed and to a textline to be shown to the user.
  2694.          Every line/function has its own level and flags, to make sure that
  2695.          not all of the menu items are available to every user.
  2696.  
  2697.          A menu line has the following fields:
  2698.  
  2699.  
  2700.          Textline..................... Textline to be displayed to the user.
  2701.  
  2702.          Hotkey....................... Key to be pressed by the user to
  2703.                                        activate this menu item.
  2704.  
  2705.          Function..................... Function to be executed.
  2706.  
  2707.          Data......................... Data associated with this menu item.
  2708.  
  2709.          Level........................ Level needed to access this menu item.
  2710.  
  2711.          Flags........................ Flags needed to access this menu item.
  2712.  
  2713.          Color........................ Color of the menu line.
  2714.  
  2715.  
  2716.  
  2717.  
  2718.  
  2719.  
  2720.  
  2721.  
  2722.  
  2723.  
  2724.  
  2725.                                       - 48 -
  2726.  
  2727.  
  2728.  
  2729.         ┌──────────────────────────────────────────────────────────────────┐
  2730.         │ Menu Security                                                    │
  2731.         └──────────────────────────────────────────────────────────────────┘
  2732.  
  2733.          To clarify menu security, here's a simple example:
  2734.  
  2735.          Suppose we have 4 users with the following levels and flags:
  2736.  
  2737.             ┌──────────────────────┬───────┬─────────┐
  2738.             │  Name                │ Level │  Flags  │
  2739.             │----------------------│-------│---------│
  2740.             │ Pete                 │   10  │    Z    │
  2741.             │ Jerry                │  100  │    P    │
  2742.             │ Al                   │  100  │    R    │
  2743.             │ Charlie              │  200  │  P & R  │
  2744.             └──────────────────────┴───────┴─────────┘
  2745.  
  2746.          Let's define a menu with textlines only:
  2747.  
  2748.             ┌───────────────────────┬───────┬────────┐
  2749.             │ Text                  │ Level │ Flags  │
  2750.             │-----------------------│-------│--------│
  2751.             │ Good morning;         │   10  │        │
  2752.             │ ,;                    │   50  │        │
  2753.             │ Jerry                 │  100  │   P    │
  2754.             │ and;                  │  150  │        │
  2755.             │ Al;                   │  100  │   R    │
  2756.             │ send their best wishes│  200  │ P & R  │
  2757.             │ .                     │  300  │        │
  2758.             │ :-)                   │   10  │   X    │
  2759.             └───────────────────────┴───────┴────────┘
  2760.  
  2761.          This would give the following result when the menu is displayed:
  2762.  
  2763.             ┌─────────────────┬─────────────────────────────────┐
  2764.             │ Pete            │ Good morning                    │
  2765.             ╞═════════════════╪═════════════════════════════════╡
  2766.             │ Jerry           │ Good morning,Jerry              │
  2767.             ╞═════════════════╪═════════════════════════════════╡
  2768.             │ Al              │ Good morning,Al                 │
  2769.             ╞═════════════════╪═════════════════════════════════╡
  2770.             │ Charlie         │ Good morning, Jerry             │
  2771.             │                 │ and Al send their best wishes   │
  2772.             └─────────────────┴─────────────────────────────────┘
  2773.  
  2774.          The last 2 lines of the menu will NEVER be displayed, because none
  2775.          of the 4 users have the required level AND flags.
  2776.  
  2777.  
  2778.  
  2779.  
  2780.  
  2781.                                       - 49 -
  2782.  
  2783.  
  2784.  
  2785.         ┌──────────────────────────────────────────────────────────────────┐
  2786.         │ Creating Menus                                                   │
  2787.         └──────────────────────────────────────────────────────────────────┘
  2788.  
  2789.          Your BBS's main menu MUST! be stored in a file called TOP.MNU.
  2790.          All the other menus can have any file name you want to give them.
  2791.  
  2792.          When you select the 'Menu Editor' option in PROCFG's main menu, a
  2793.          new window will be opened containing the menus already available
  2794.          (if any).
  2795.  
  2796.          In this window, you can use the following keys:
  2797.  
  2798.            - Up/Down       Scroll up/down.
  2799.            - Enter         Select a menu.
  2800.            - Ins           Add a menu.
  2801.  
  2802.          When you have selected a menu, a list of all the menu items will
  2803.          be displayed. To add a menu item, just move past the last item and
  2804.          press <Enter>. To insert an item, press <Ins>, to remove one,
  2805.          press <Del>. To edit a menu item, move the selector to that item
  2806.          and press <Enter>. You can change the menu prompt and highlight
  2807.          colors by pressing <Alt-P>. If you want to see how a menu will look,
  2808.          press <Alt-S>. You can also copy and paste menu items. To copy
  2809.          an item, move to the item you want to copy, and press <Alt-C>. To
  2810.          insert the copied item somewhere else, move to the place where you
  2811.          want the menu item, and press <Ctrl-P>. You can even copy and paste
  2812.          items across different menus.
  2813.  
  2814.          A menu item has the following fields:
  2815.  
  2816.  
  2817.          Textline..................... This is the string to be displayed.
  2818.                                        Leaving this field blank causes a
  2819.                                        blank line to be displayed to the
  2820.                                        user. A CR/LF will be sent after
  2821.                                        the menu line. To avoid this, just
  2822.                                        enter a ';' as the last character.
  2823.                                        This will cause the next textline
  2824.                                        of the menu to be appended to this
  2825.                                        one.
  2826.  
  2827.  
  2828.  
  2829.  
  2830.  
  2831.  
  2832.  
  2833.  
  2834.  
  2835.  
  2836.  
  2837.                                       - 50 -
  2838.  
  2839.  
  2840.  
  2841.                                        Special textline characters:
  2842.  
  2843.                                           ^ : Switches between normal and
  2844.                                               highlighted color.
  2845.                                           ~ : Replaced by the number of
  2846.                                               minutes the user has left in
  2847.                                               this session.
  2848.                                           ` : Replaced by the name of the
  2849.                                               current message area (more
  2850.                                               about this later).
  2851.                                           @ : Replaced by the name of the
  2852.                                               current file area (more about
  2853.                                               this later).
  2854.  
  2855.                                        This textline can also contain text
  2856.                                        macros like @<NAME>@ or @<NODE>@.
  2857.                                        More about this in the "Text macros"
  2858.                                        section.
  2859.  
  2860.                                        You are not limited to two colors in
  2861.                                        menu lines. You can use the codes
  2862.                                        \1 to \7 to change colors, or \0 to
  2863.                                        return to the original color.
  2864.  
  2865.  
  2866.          Hotkey....................... Most of the menu functions must be
  2867.                                        chosen by the user, so ProBoard must
  2868.                                        react to certain key-presses from
  2869.                                        the user. Receiving the hotkey for a
  2870.                                        certain menu item will cause
  2871.                                        ProBoard to execute the function
  2872.                                        associated with this item.
  2873.                                        The hotkey can be any ASCII
  2874.                                        character or digit,but one character
  2875.                                        has a special meaning to ProBoard:
  2876.                                        <Ctrl-A> will make this function
  2877.                                        AUTOEXEC, which means that
  2878.                                        this function will be executed as
  2879.                                        soon as this menu item is displayed
  2880.                                        (without really selecting this
  2881.                                        option).
  2882.  
  2883.          Function..................... The function associated with this
  2884.                                        menu item. Pressing the <Enter> key
  2885.                                        will cause a complete list of all
  2886.                                        the menu functions to be displayed
  2887.                                        in a separate window.
  2888.  
  2889.  
  2890.  
  2891.  
  2892.  
  2893.                                       - 51 -
  2894.  
  2895.  
  2896.  
  2897.          Data......................... This field is optional with some of
  2898.                                        the functions. Basically, in this
  2899.                                        field you enter the parameters of a
  2900.                                        menu function. Eg. function 40
  2901.                                        (Display ASC/ANS file) needs a file-
  2902.                                        name as data (parameter). Function 1
  2903.                                        (Goto menu) needs the name of the
  2904.                                        menu to be jumped to. Text macros
  2905.                                        can be inserted (see "Text macros"
  2906.                                        section).
  2907.  
  2908.          Level........................ Level needed to access this menu
  2909.                                        item.
  2910.  
  2911.          Flags........................ Flags needed to access this menu
  2912.                                        item.
  2913.  
  2914.          Color........................ Color for the menu's textline to be
  2915.                                        displayed in.
  2916.  
  2917.  
  2918.  
  2919.         ┌──────────────────────────────────────────────────────────────────┐
  2920.         │ Hints                                                            │
  2921.         └──────────────────────────────────────────────────────────────────┘
  2922.  
  2923.          You can create a menu by using textlines, but you can also create
  2924.          menus that display a file to the user, in which all the options
  2925.          are shown. This technique works as follows:
  2926.  
  2927.          The first item in the menu should have ';' as textline and
  2928.          <Ctrl-A> (autoexec) as hotkey. The function to be executed should
  2929.          be function 40 (Display file with hotkeys). When the user accesses
  2930.          this menu, the specified file will immediately be sent. Setting
  2931.          all the remaining textlines of the menu to ';' will cause
  2932.          NOTHING BUT this file to be displayed.
  2933.          Combined with the use of text macros, this allows you to show
  2934.          different looking menus for each node you are running. For
  2935.          example, if you use function 40, and enter "MAIN@<NODE>@" in the
  2936.          data field, node 1 will see file MAIN1 , node 2 will see MAIN2,
  2937.          etc... This feature could be used to create a completely different
  2938.          set of menus for each node on your board!
  2939.  
  2940.          If you need more information about all the possiblities, take a
  2941.          look at the example menus.
  2942.  
  2943.  
  2944.  
  2945.  
  2946.  
  2947.  
  2948.  
  2949.                                       - 52 -
  2950.  
  2951.  
  2952.  
  2953.         ┌──────────────────────────────────────────────────────────────────┐
  2954.         │ Menu Function Summary                                            │
  2955.         └──────────────────────────────────────────────────────────────────┘
  2956.  
  2957.          The following is a summary list of the ProBoard Menu Functions.
  2958.  
  2959.          Each Menu Function is explained in detail in the following section
  2960.          titled "Menu Functions Overview".
  2961.  
  2962.          Function        Action Performed                             Page
  2963.          ───────────     ──────────────────────────────────────────   ────
  2964.  
  2965.          Function 1 .... GOTO Menu ................................    55
  2966.          Function 2 .... GOSUB Menu ...............................    56
  2967.          Function 3 .... GOTO Previous Menu .......................    58
  2968.          Function 4 .... GOTO Menu and Clear Menu Stack ...........    58
  2969.          Function 5 .... Show ANS/ASC File.........................    59
  2970.          Function 6 .... Change State/Country......................    59
  2971.          Function 7 .... Shell ....................................    59
  2972.          Function 8 .... Show Version Information .................    62
  2973.          Function 9 .... Log Off ..................................    62
  2974.          Function 10 ... Show System Useage Per Hour (Graph) ......    62
  2975.          Function 11 ... Chat Request .............................    63
  2976.          Function 12 ... Execute Questionaire Script ..............    63
  2977.          Function 13 ... Display User List ........................    67
  2978.          Function 14 ... Display Time Info ........................    67
  2979.          Function 15 ... Show A?? File and Wait ...................    67
  2980.          Function 16 ... Change City ..............................    67
  2981.          Function 17 ... Change Password ..........................    68
  2982.          Function 18 ... Change Screen Length .....................    68
  2983.          Function 19 ... Toggle Screen Clearing Codes .............    68
  2984.          Function 20 ... Toggle More Prompt .......................    69
  2985.          Function 21 ... Toggle ANSI Codes ........................    70
  2986.          Function 22 ... Check for Personal Mail / Files ..........    70
  2987.          Function 23 ... Read Messages ............................    71
  2988.          Function 24 ... Scan Messages ............................    72
  2989.          Function 25 ... Quick Scan Messages ......................    72
  2990.          Function 26 ... Show System Usage by Day (Graph) .........    73
  2991.          Function 27 ... Write a Message ..........................    73
  2992.          Function 28 ... Combined Boards Select ...................    74
  2993.          Function 29 ... Display System Useage Per Week (Graph)....    74
  2994.          Function 30 ... Show Directory ...........................    74
  2995.          Function 31 ... List Files ...............................    75
  2996.          Function 32 ... Download a File ..........................    77
  2997.          Function 33 ... Upload a File ............................    78
  2998.          Function 34 ... View an Archive ..........................    78
  2999.          Function 35 ... File Search by Keyword ...................    79
  3000.  
  3001.  
  3002.  
  3003.  
  3004.  
  3005.                                       - 53 -
  3006.  
  3007.  
  3008.  
  3009.          Function        Action Performed                             Page
  3010.          ───────────     ──────────────────────────────────────────   ────
  3011.  
  3012.          Function 36 ... File Search by File Name .................    78
  3013.          Function 37 ... Show New Files ...........................    78
  3014.          Function 38 ... View a File ..............................    80
  3015.          Function 39 ... Display Named File .......................    80
  3016.          Function 40 ... Display A?? File with Menu HotKeys .......    80
  3017.          Function 41 ... Toggle the Full Screen Editor ............    81
  3018.          Function 42 ... Toggle Command Stacking/Hotkeys ..........    81
  3019.          Function 43 ... Clear Marked Messages ....................    82
  3020.          Function 44 ... Global Combined Boards Selection .........    82
  3021.          Function 45 ... Display Text File and Wait ...............    82
  3022.          Function 46 ... Change User Level and/or Flags ...........    82
  3023.          Function 47 ... Make a Log Entry .........................    83
  3024.          Function 48 ... Show Hit Parade ..........................    83
  3025.          Function 49 ... Select Message Area ......................    84
  3026.          Function 50 ... Show Users Online ........................    84
  3027.          Function 51 ... List Last Callers ........................    85
  3028.          Function 52 ... Remote User Editor .......................    85
  3029.          Function 53 ... Multi-Line (Internode) Chat ..............    85
  3030.          Function 54 ... Select File Area .........................    86
  3031.          Function 55 ... Show .GIF File Information ...............    86
  3032.          Function 56 ... Toggle IBM Characters ....................    86
  3033.          Function 57 ... Change Phone Number ......................    86
  3034.          Function 58 ... Change Data/Fax Phone Number .............    87
  3035.          Function 59 ... Change User Alias (Handle) ...............    87
  3036.          Function 60 ... Run ProBoard SDK File ....................    87
  3037.          Function 61 ... Bulletin Menu ............................    88
  3038.          Function 62 ... Toggle AVATAR/0 ..........................    88
  3039.          Function 63 ... Toggle AVATAR/0+ .........................    89
  3040.  
  3041.  
  3042.  
  3043.  
  3044.  
  3045.  
  3046.  
  3047.  
  3048.  
  3049.  
  3050.  
  3051.  
  3052.  
  3053.  
  3054.  
  3055.  
  3056.  
  3057.  
  3058.  
  3059.  
  3060.  
  3061.                                       - 54 -
  3062.  
  3063.  
  3064.  
  3065.         ┌──────────────────────────────────────────────────────────────────┐
  3066.         │ Menu Functions Overview                                          │
  3067.         └──────────────────────────────────────────────────────────────────┘
  3068.  
  3069.          In this function overview, parameters between <> are REQUIRED,
  3070.          and parameters between [] are optional.
  3071.  
  3072.               For example:  <blank> is a required parameter.
  3073.                             [/M] is an option you might specify in addition.
  3074.  
  3075.  
  3076.  
  3077.  
  3078.         ┌──────────────────────────────────────────────────────────────────┐
  3079.         │ Function 1: GOTO MENU                                            │
  3080.         └──────────────────────────────────────────────────────────────────┘
  3081.  
  3082.          DATA: <menu name> [/M=<nr msgarea>] [/F=<nr filearea>] [/P=<pwd>]
  3083.  
  3084.  
  3085.          This function makes ProBoard jump to menu <menu name>.
  3086.  
  3087.          Option /M can be used to define one single menu for several
  3088.          message areas. You could jump to a 'general' message area menu and
  3089.          pass option /M=3, to make message area 3 active for the selected
  3090.          menu. Please refer to function 23 (Read messages) for more
  3091.          information about this option.
  3092.  
  3093.          Option /F works exactly the same, but applies to file areas.
  3094.  
  3095.          It is possible to protect a menu with a password by using the /P=
  3096.          option. For example: "SYSOP /P=Test" would protect menu "SYSOP"
  3097.          with the password "Test". The user will have to enter this
  3098.          password to be allowed to move to the menu.
  3099.  
  3100.          It is also possible to select the next available message or file
  3101.          areas with the use of the following parameters.
  3102.  
  3103.            /M=+   (set next accessible Message Area)
  3104.            /M=-   (set previous accessible Message Area)
  3105.            /F=+   (set next available File Area)
  3106.            /F=-   (set previous accessible File Area)
  3107.  
  3108.          Data examples:
  3109.  
  3110.  
  3111.  
  3112.  
  3113.  
  3114.  
  3115.  
  3116.  
  3117.                                       - 55 -
  3118.  
  3119.  
  3120.  
  3121.            MSG /M=5
  3122.            ────────
  3123.            This makes ProBoard GOTO the menu named "MSG" and sets the
  3124.            Message Area to Area #5.
  3125.  
  3126.            FILE /F=10
  3127.            ──────────
  3128.            This makes ProBoard display the menu named "FILE" and sets the
  3129.            File Area to Area #10
  3130.  
  3131.            MSG /M=+
  3132.            ────────
  3133.            This makes ProBoard display the menu named "MSG" and selects the
  3134.            next Message Area that is available to this caller.
  3135.  
  3136.            FILE /F=-
  3137.            ─────────
  3138.            This makes ProBoard display the menu named "FILE" and selects the
  3139.            previous File Area that is available to this caller.
  3140.  
  3141.  
  3142.  
  3143.         ┌──────────────────────────────────────────────────────────────────┐
  3144.         │ Function 2: GOSUB MENU                                           │
  3145.         └──────────────────────────────────────────────────────────────────┘
  3146.  
  3147.  
  3148.  
  3149.  
  3150.  
  3151.  
  3152.  
  3153.  
  3154.  
  3155.  
  3156.  
  3157.  
  3158.  
  3159.  
  3160.  
  3161.  
  3162.  
  3163.  
  3164.  
  3165.  
  3166.  
  3167.  
  3168.  
  3169.  
  3170.  
  3171.  
  3172.  
  3173.                                       - 56 -
  3174.  
  3175.  
  3176.  
  3177.  
  3178.          DATA: <menu name> [/M=<nr msgarea>] [/F=<nr filearea>] [/P=pwd]
  3179.  
  3180.  
  3181.          This function is largely the same as the Menu Function 1 (it
  3182.          even has the same parameters), but the menu this function is
  3183.          called from is pushed onto an internal stack. ProBoard will jump
  3184.          back to this menu when returning from menu <menu name> (by
  3185.          executing Menu Function 3).
  3186.  
  3187.          Data examples:  (see Menu Function 1 for complete parameters)
  3188.  
  3189.            MSG /M=5
  3190.            ────────
  3191.            This makes ProBoard display the menu named "MSG" and sets the
  3192.            Message Area to Area #5.  It also places the previous menu on
  3193.            a stack.  The previous menu can be returned to by using Menu
  3194.            Function 3.
  3195.  
  3196.            FILE /F=10
  3197.            ──────────
  3198.            This makes ProBoard display the menu named "FILE" and sets the
  3199.            File Area to Area #10.  It also places the previous menu on
  3200.            a stack.  The previous menu can be returned to by using Menu
  3201.            Function 3.
  3202.  
  3203.            MSG /M=+
  3204.            ────────
  3205.            This makes ProBoard display the menu named "MSG" and selects the
  3206.            next Message Area that is available to this caller.  It also
  3207.            places the previous menu on a stack.  The previous menu can be
  3208.            returned to by using Menu Function 3.
  3209.  
  3210.            FILE /F=-
  3211.            ─────────
  3212.            This makes ProBoard display the menu named "FILE" and selects
  3213.            the previous File Area that is available to this caller.  It
  3214.            also places the previous menu on a stack.  The previous menu
  3215.            can be returned to by using Menu Function 3.
  3216.  
  3217.  
  3218.  
  3219.  
  3220.  
  3221.  
  3222.  
  3223.  
  3224.  
  3225.  
  3226.  
  3227.  
  3228.  
  3229.                                       - 57 -
  3230.  
  3231.  
  3232.  
  3233.         ┌──────────────────────────────────────────────────────────────────┐
  3234.         │ Function 3: GOTO PREVIOUS MENU                                   │
  3235.         └──────────────────────────────────────────────────────────────────┘
  3236.  
  3237.          DATA: -
  3238.  
  3239.  
  3240.          This function makes ProBoard go back to the previous menu if you
  3241.          used Menu Function 2.
  3242.  
  3243.  
  3244.  
  3245.         ┌──────────────────────────────────────────────────────────────────┐
  3246.         │ Function 4: GOTO MENU & CLEAR STACK                              │
  3247.         └──────────────────────────────────────────────────────────────────┘
  3248.  
  3249.          DATA: <menu name> [/M=<nr msgarea>] [/F=<nr filearea>] [/P=pwd]
  3250.  
  3251.  
  3252.          This function performs the same tasks as Menu Function 1, but will
  3253.          clear the existing menu stack, thus preventing the user from
  3254.          returning to the previous menu.
  3255.  
  3256.          Data examples:  (see Menu Function 1 for complete parameters)
  3257.  
  3258.            MSG /M=5
  3259.            ────────
  3260.            This makes ProBoard display the menu named "MSG" and sets the
  3261.            Message Area to Area #5.  The menu stack will be cleared
  3262.            preventing return to any previous menus already on the stack.
  3263.  
  3264.            FILE /F=10
  3265.            ──────────
  3266.            This makes ProBoard display the menu named "FILE" and sets the
  3267.            File Area to Area #10.  The menu stack will be cleared
  3268.            preventing return to any previous menus already on the stack.
  3269.  
  3270.            MSG /M=+
  3271.            ────────
  3272.            This makes ProBoard display the menu named "MSG" and selects the
  3273.            next Message Area that is available to this caller.  The menu
  3274.            stack will be cleared preventing return to any previous menus
  3275.            already on the stack.
  3276.  
  3277.            FILE /F=-
  3278.            ─────────
  3279.            This makes ProBoard display the menu named "FILE" and selects the
  3280.            previous File Area that is available to this caller.  The
  3281.            stack will be cleared preventing return to any previous menus
  3282.            already on the stack.
  3283.  
  3284.  
  3285.                                       - 58 -
  3286.  
  3287.  
  3288.  
  3289.         ┌──────────────────────────────────────────────────────────────────┐
  3290.         │ Function 5: SHOW ANS/ASC FILE                                    │
  3291.         └──────────────────────────────────────────────────────────────────┘
  3292.  
  3293.          DATA: <filename>
  3294.  
  3295.  
  3296.          This function displays a file to the user with the extension .ANS
  3297.          or .ASC, depending on the user's ANSI-setting. The file must be
  3298.          stored in ProBoard's textfiles directory; <filename> should NOT
  3299.          contain an extension (max. eight characters). If ProBoard doesn't
  3300.          find the .ANS file, it will look for the .ASC file.
  3301.  
  3302.  
  3303.  
  3304.         ┌──────────────────────────────────────────────────────────────────┐
  3305.         │ Function 6: CHANGE COUNTRY                                       │
  3306.         └──────────────────────────────────────────────────────────────────┘
  3307.  
  3308.          DATA: -
  3309.  
  3310.  
  3311.          Allows the user to change the country in his user-record.
  3312.  
  3313.  
  3314.  
  3315.         ┌──────────────────────────────────────────────────────────────────┐
  3316.         │ Function 7: SHELL                                                │
  3317.         └──────────────────────────────────────────────────────────────────┘
  3318.  
  3319.          DATA: <command line>
  3320.  
  3321.  
  3322.          With this function, you can instruct ProBoard to execute an
  3323.          external program. This program has to do its own serial I/O, so
  3324.          ordinary programs will only work if run locally.
  3325.  
  3326.          Parameter <command line> needs full path and filename (.COM or
  3327.          .EXE extension included), and may contain some special codes.
  3328.          These codes will (at run-time) be replaced by a value or a string.
  3329.  
  3330.          Special codes:
  3331.  
  3332.              **      Replaced by an asterisk ('*')
  3333.  
  3334.              *#      Replaced by the node number.
  3335.  
  3336.              *\      Sends the message "Sysop is shelling..." to the user
  3337.                      before the shell is executed, and the message "Sysop
  3338.                      has returned..." afterwards.
  3339.  
  3340.  
  3341.                                       - 59 -
  3342.  
  3343.  
  3344.  
  3345.              *!      Freezes ProBoard's system timer when shelling.
  3346.  
  3347.              *=      Do not call any fossil functions when shelling.  Great
  3348.                      for use in INIT.PEX files.
  3349.  
  3350.              *A      Writes a user's handle (alias) to DORINFOx.DEF instead
  3351.                      of his/her real name.
  3352.  
  3353.              *B      Current baud rate.
  3354.  
  3355.              *C      Replaced by the full name & path of the command
  3356.                      interpreter. It is the contents of the environment
  3357.                      variable "COMSPEC". This usually is C:\COMMAND.COM.
  3358.  
  3359.              *D      Writes a DOOR.SYS file to the current directory before
  3360.                      shelling.
  3361.  
  3362.              *E      Writes EXITINFO.BBS to the current directory before
  3363.                      shelling and reads it back afterwards.
  3364.  
  3365.              *F      User's first name.
  3366.  
  3367.              *G      Indicates whether user has ANSI (1) or ASCII (0) set.
  3368.  
  3369.              *H      Tells ProBoard not to disable the fossil driver when
  3370.                      shelling.
  3371.  
  3372.              *I      Maximum user-inactivity (seconds).
  3373.  
  3374.              *L      User's last name.
  3375.  
  3376.              *M      ProBoard's start-up directory (including trailing '\')
  3377.  
  3378.              *N      Shell will NOT be logged in PROBOARD.LOG.
  3379.  
  3380.              *O      (not zero!) is replaced by the path of the current
  3381.                      file area.
  3382.  
  3383.              *P      Com-port used by ProBoard (1-8).
  3384.  
  3385.              *Q      Don't let user know that ProBoard is shelling (!).
  3386.  
  3387.              *R      User's record number in USERS.BBS.
  3388.  
  3389.              *S      ProBoard's system directory (incl. trailing '\')
  3390.  
  3391.              *T      Time left for the user today (minutes).
  3392.  
  3393.              *V      Disables adding 2 to the graphics capability line in
  3394.                      DORINFOx.DEF when the user has AVATAR enabled.
  3395.  
  3396.  
  3397.                                       - 60 -
  3398.  
  3399.  
  3400.  
  3401.              *W      Runs the shell in a window , so the status on the last
  3402.                      line will not be cleared. This option only works with
  3403.                      programs that send their output to the standard output
  3404.                      device (no direct screen writes).
  3405.  
  3406.              *X      ALWAYS SWAP to disk/EMS, even if swapping is enabled
  3407.                      in ProCFG.
  3408.  
  3409.              *Y      DO NOT SWAP to disk/EMS.
  3410.  
  3411.              *Z      Execute the command as if you typed it from the
  3412.                      command line. The main use for this option is to
  3413.                      execute DOS batch files. It is exactly the same as
  3414.                      entering "*C /C <command>". It can also be useful to
  3415.                      execute programs that are located in your path,
  3416.                      without having to specify the exact directory name.
  3417.  
  3418.              *_      (asterisk underscore) Tells ProBoard not to write
  3419.                      underscores instead of spaces when writing a user's
  3420.                      last name in DORINFOx.DEF. For example, users name is
  3421.                      Harvey Van Hooten.  Without this parameter, users name
  3422.                      will be written to DORINFOx.DEF as follows:
  3423.  
  3424.                        HARVEY VAN_HOOTEN
  3425.  
  3426.                      By using the *_ (asterisk underscore) the users name
  3427.                      will be written to DORINFOx.DEF as follows:
  3428.  
  3429.                        HARVEY VAN HOOTEN (with no underscore in last name)
  3430.  
  3431.              *0      (zero) ProBoard will write a DORINFO1.DEF instead of a
  3432.                      DORINFO<node>.DEF - great for running doors which
  3433.                      require a DORINFO1.DEF file on a multi node ProBoard
  3434.                      system.
  3435.  
  3436.              *1      Installs a timer-function when shelling, which
  3437.                      continuously redisplays the user's status line on the
  3438.                      first screenline. This can be used with ALL programs.
  3439.                      (Works great most full-screen protocols!)
  3440.  
  3441.              *2      Same as *1, but uses the bottom screenline (try this
  3442.                      with QuickEd!)
  3443.  
  3444.  
  3445.          Suppose ProBoard is in directory D:\PB.
  3446.  
  3447.          Data example: *Q*STEST.EXE *B
  3448.  
  3449.          ProBoard will execute D:\PB\TEST.EXE 2400 and the user won't see
  3450.          this happening.
  3451.  
  3452.  
  3453.                                       - 61 -
  3454.  
  3455.  
  3456.  
  3457.          To execute a batch file, you have to use the following syntax:
  3458.          "*Z<filename>.BAT <parameters>". This is expanded to:
  3459.          "*C /C <filename>.BAT <parameters>".
  3460.  
  3461.          When shelling, ProBoard writes a standard DORINFOx.DEF file, where
  3462.          x stands for the node-number. An RA-compatible EXITINFO.BBS file
  3463.          and a DOORWAY-compatible DOOR.SYS can also be created by
  3464.          specifying the *E and/or *D options. All these files are created
  3465.          in the directory where ProBoard is started from.
  3466.  
  3467.  
  3468.  
  3469.         ┌──────────────────────────────────────────────────────────────────┐
  3470.         │ Function 8: SHOW VERSION INFORMATION                             │
  3471.         └──────────────────────────────────────────────────────────────────┘
  3472.  
  3473.          DATA: -
  3474.  
  3475.  
  3476.          This function shows information about ProBoard's version number.
  3477.          If you have a registered copy of ProBoard, the Sysop's name and
  3478.          BBS-name will be shown. With this function, you can show off to
  3479.          your users that you're a nice Sysop: one that registered!
  3480.  
  3481.  
  3482.  
  3483.         ┌──────────────────────────────────────────────────────────────────┐
  3484.         │ Function 9: LOGOFF                                               │
  3485.         └──────────────────────────────────────────────────────────────────┘
  3486.  
  3487.          DATA: -
  3488.  
  3489.  
  3490.          Shows the file GOODBYE.ANS/ASC and hangs up the phone.
  3491.  
  3492.  
  3493.  
  3494.         ┌──────────────────────────────────────────────────────────────────┐
  3495.         │ Function 10: SHOW SYSTEM USAGE PER HOUR (GRAPH)                  │
  3496.         └──────────────────────────────────────────────────────────────────┘
  3497.  
  3498.          DATA: -
  3499.  
  3500.  
  3501.          Shows a bar graph of the average system usage per hour. From the
  3502.          day you install ProBoard, it will keep track of a usage rate per
  3503.          hour and per day. If you want to change the usage values, just
  3504.          edit the values using ProCFG.
  3505.  
  3506.  
  3507.  
  3508.  
  3509.                                       - 62 -
  3510.  
  3511.  
  3512.  
  3513.         ┌──────────────────────────────────────────────────────────────────┐
  3514.         │ Function 11: CHAT REQUEST                                        │
  3515.         └──────────────────────────────────────────────────────────────────┘
  3516.  
  3517.          DATA: -
  3518.  
  3519.  
  3520.          This function allows the user to make a request to chat with the
  3521.          Sysop. The user will be prompted for a reason why he wants to
  3522.          chat. The minimal length of this reason must be 5 characters.
  3523.          If the Sysop does not answer, the status line will start flashing,
  3524.          indicating that the users wants to chat. You can view the reason
  3525.          for the chat by pressing <F8>.
  3526.  
  3527.          You can define your own page-tune by creating a RemoteAccess-
  3528.          compatible description file. The format of this file is described
  3529.          in the reference section.
  3530.  
  3531.  
  3532.  
  3533.         ┌──────────────────────────────────────────────────────────────────┐
  3534.         │ Function 12: EXECUTE QUESTIONNAIRE SCRIPT                        │
  3535.         └──────────────────────────────────────────────────────────────────┘
  3536.  
  3537.          DATA: <scriptname>
  3538.  
  3539.  
  3540.          This function executes a questionnaire. A questionnaire is a
  3541.          common ASCII-file containing several commands to be executed by
  3542.          ProBoard. A questionnaire scriptfile has an extension .Q-A, and
  3543.          the user's answers will be stored in a file with the same
  3544.          filename, but with extension .ASW.
  3545.          Starting from version 1.15, you can write very powerful
  3546.          questionnaires by using the ProBoard SDK.
  3547.  
  3548.          You can use the following commands in a scriptfile:
  3549.  
  3550.  
  3551.          ASK <length> <number of variable>
  3552.  
  3553.               eg: Ask 10 1
  3554.  
  3555.          Asks the user something. The user has <length> characters to
  3556.          answer, and the answer will be stored in the variable <number
  3557.          of variable>. The maximum number of variables in ProBoard is 20.
  3558.  
  3559.  
  3560.  
  3561.  
  3562.  
  3563.  
  3564.  
  3565.                                       - 63 -
  3566.  
  3567.  
  3568.  
  3569.          CHANGECOLOR <color>
  3570.  
  3571.               eg: ChangeColor 3
  3572.  
  3573.          Changes the color in which the following text will be displayed.
  3574.          The number <color> is the ANSI color code, which means that this
  3575.          function works only for users who use ANSI.
  3576.  
  3577.  
  3578.          CLEARSCREEN
  3579.  
  3580.          Well, what do you think?
  3581.  
  3582.  
  3583.          DISPLAY "<string>"
  3584.  
  3585.               eg: Display "Hi there!"
  3586.  
  3587.          Displays a string <string>. The string must be contained in double
  3588.          quotes; a '|' in a string will be replaced by CR/LF (new line).
  3589.  
  3590.  
  3591.          IF <number of variable> = "<string>"
  3592.  
  3593.                 eg. If 1 = "Y"
  3594.  
  3595.          Directs the .Q-A file according to the user's answers.
  3596.          If the condition is met, all commands after the IF-statement will
  3597.          be executed, until an ENDIF is encountered.
  3598.  
  3599.  
  3600.          ENDIF
  3601.  
  3602.          Ends an IF-statement.
  3603.  
  3604.               eg: Display "Do you have a hard disk?"
  3605.                   GetChoice YN 1
  3606.                   If 1 = "Y"
  3607.                     Display "Storage space in Mb?"
  3608.                     Ask 2
  3609.                   EndIf
  3610.                   Display "..."
  3611.  
  3612.  
  3613.          GETCHOICE <options> <number of variable>
  3614.  
  3615.               eg: GetChoice YN 1
  3616.  
  3617.          Forces the user to give a proper answer, chosen from <options>.
  3618.  
  3619.  
  3620.  
  3621.                                       - 64 -
  3622.  
  3623.  
  3624.  
  3625.          OUTPUTANSWER ["<description>"] <number of variable>
  3626.  
  3627.               eg: OutputAnswer "Name: " 1
  3628.  
  3629.          Writes ["<description>"] and the value in <number of variable> to
  3630.          the .ASW-file. <description> is optional.
  3631.  
  3632.  
  3633.          POSTINFO
  3634.  
  3635.          Writes a header to the .ASW-file. The header contains some general
  3636.          information about the user ("Peter Piper answered on ...").
  3637.  
  3638.  
  3639.  
  3640.          QUIT
  3641.  
  3642.          Ends execution of the questionnaire script.
  3643.  
  3644.  
  3645.  
  3646.          SETFLAG <flag> <ON/OFF>
  3647.  
  3648.               eg: SetFlag C ON
  3649.  
  3650.          Sets/clears user flag <flag>. For compatibility with RA, it is also
  3651.          possible to use the QuickBBS/RA flags (A1-D8)
  3652.  
  3653.  
  3654.  
  3655.          SETSECURITY <level>
  3656.  
  3657.               eg: SetSecurity 20
  3658.  
  3659.          Changes the user's security level.
  3660.  
  3661.  
  3662.  
  3663.          CAPITALISE [On|Off]
  3664.  
  3665.               eg: Capitalise On
  3666.  
  3667.          Changes the way input from the user is displayed. When ON, all
  3668.          characters typed will be converted to uppercase.
  3669.  
  3670.  
  3671.  
  3672.  
  3673.  
  3674.  
  3675.  
  3676.  
  3677.                                       - 65 -
  3678.  
  3679.  
  3680.  
  3681.          DISPLAYFILE <filename>
  3682.  
  3683.               eg: DisplayFile TEST
  3684.  
  3685.          Displays <filename>.ANS/ASC. It is identical to menu function 5.
  3686.  
  3687.  
  3688.  
  3689.          EXEC <command>
  3690.  
  3691.               eg: Exec "*ZECHO TEST"
  3692.  
  3693.          Execute a shell. It is identical to function 7. Note that you MUST
  3694.          use quotes (") if the command contains any spaces.
  3695.  
  3696.  
  3697.  
  3698.          LISTANSWER <var-num>
  3699.  
  3700.               eg: ListAnswer 4
  3701.  
  3702.          Displays variable <var-num>, with a CR/LF at the end.
  3703.  
  3704.  
  3705.  
  3706.          MENUCMND <num> [data]
  3707.  
  3708.               eg: MenuCmnd 11 "Yelling Sysop..."
  3709.  
  3710.          Execute any menu command. If the data field contains spaces, you
  3711.          MUST use quotes (").
  3712.  
  3713.  
  3714.  
  3715.          WAITENTER
  3716.  
  3717.               eg: WaitEnter
  3718.  
  3719.          Waits for the <Enter> key.
  3720.  
  3721.  
  3722.  
  3723.  
  3724.  
  3725.  
  3726.  
  3727.  
  3728.  
  3729.  
  3730.  
  3731.  
  3732.  
  3733.                                       - 66 -
  3734.  
  3735.  
  3736.  
  3737.         ┌──────────────────────────────────────────────────────────────────┐
  3738.         │ Function 13: DISPLAY USERLIST                                    │
  3739.         └──────────────────────────────────────────────────────────────────┘
  3740.  
  3741.          DATA: -
  3742.  
  3743.  
  3744.          Prompts the user for a name (or part of a name) and goes looking
  3745.          for it in the name fields of USERS.BBS. If the user doesn't
  3746.          specify a string (if he presses <Enter>), the entire userlist
  3747.          will be displayed.  ProBoard uses a built-in "fuzzy search"
  3748.          algorithm, which will locate specific users even if you misspell
  3749.          their name.
  3750.  
  3751.  
  3752.  
  3753.         ┌──────────────────────────────────────────────────────────────────┐
  3754.         │ Function 14: DISPLAY TIME INFO                                   │
  3755.         └──────────────────────────────────────────────────────────────────┘
  3756.  
  3757.          DATA: -
  3758.  
  3759.  
  3760.          Displays information about the current time, time online,
  3761.          remaining time, etc.
  3762.  
  3763.  
  3764.  
  3765.         ┌──────────────────────────────────────────────────────────────────┐
  3766.         │ Function 15: SHOW ANS/ASC FILE & WAIT                            │
  3767.         └──────────────────────────────────────────────────────────────────┘
  3768.  
  3769.          DATA: <filename>
  3770.  
  3771.  
  3772.          Displays an ANS/ASC-file (like function 5) and waits for the user
  3773.          to press <Enter>.
  3774.  
  3775.  
  3776.  
  3777.         ┌──────────────────────────────────────────────────────────────────┐
  3778.         │ Function 16: CHANGE CITY                                         │
  3779.         └──────────────────────────────────────────────────────────────────┘
  3780.  
  3781.          DATA: -
  3782.  
  3783.  
  3784.          Allows the user to change the city in his user-record.
  3785.  
  3786.  
  3787.  
  3788.  
  3789.                                       - 67 -
  3790.  
  3791.  
  3792.  
  3793.         ┌──────────────────────────────────────────────────────────────────┐
  3794.         │ Function 17: CHANGE PASSWORD                                     │
  3795.         └──────────────────────────────────────────────────────────────────┘
  3796.  
  3797.          DATA: -
  3798.  
  3799.  
  3800.          Allows the user to change his password.
  3801.  
  3802.  
  3803.  
  3804.         ┌──────────────────────────────────────────────────────────────────┐
  3805.         │ Function 18: CHANGE SCREENLENGTH                                 │
  3806.         └──────────────────────────────────────────────────────────────────┘
  3807.  
  3808.          DATA: -
  3809.  
  3810.  
  3811.          Allows the user to change his screen's length (# lines).
  3812.  
  3813.  
  3814.  
  3815.         ┌──────────────────────────────────────────────────────────────────┐
  3816.         │ Function 19: TOGGLE CLEARSCREEN CODES                            │
  3817.         └──────────────────────────────────────────────────────────────────┘
  3818.  
  3819.          DATA: <blank> or <parameter>
  3820.  
  3821.  
  3822.          Allows the user to decide whether he wants clearscreen-codes sent
  3823.          or not.
  3824.  
  3825.          In the data field, you can enter these parameters:
  3826.  
  3827.            Ask       Will ask for new status
  3828.            On        Toggles option on
  3829.            Off       Toggles option off
  3830.            Toggle    Toggles option (reverse of current condition)
  3831.            Save      Save current status for this option
  3832.            Restore   Restore status saved by "Save"
  3833.            /Q        Quiet. Do not display "xxxx is now enabled/disabled"
  3834.  
  3835.          Example: "Ask /Q"
  3836.  
  3837.            This will ask the user if they want to enable or disable screen
  3838.            clearing and ProBoard will not display: "Screen Clearing is now
  3839.            enabled/disabled".
  3840.  
  3841.  
  3842.          "Toggle" parameter.
  3843.  
  3844.  
  3845.                                       - 68 -
  3846.  
  3847.  
  3848.  
  3849.         ┌──────────────────────────────────────────────────────────────────┐
  3850.         │ Function 20: TOGGLE MORE PROMPT                                  │
  3851.         └──────────────────────────────────────────────────────────────────┘
  3852.  
  3853.          DATA: <blank> or <parameter>
  3854.  
  3855.  
  3856.          Allows the user to decide whether scrolling should pause when the
  3857.          screen is full.
  3858.  
  3859.          In the data field, you can enter these parameters:
  3860.  
  3861.            Ask       Will ask for new status
  3862.            On        Toggles option on
  3863.            Off       Toggles option off
  3864.            Toggle    Toggles option (reverse of current condition)
  3865.            Save      Save current status for this option
  3866.            Restore   Restore status saved by "Save"
  3867.            /Q        Quiet. Do not display "xxxx is now enabled/disabled"
  3868.  
  3869.          Example: "Ask /Q"
  3870.  
  3871.            This will ask the user if they want to enable or disable the
  3872.            More? prompt, and ProBoard will not display: "Page Pausing is now
  3873.            enabled/disabled".
  3874.  
  3875.  
  3876.          "Toggle" parameter.
  3877.  
  3878.  
  3879.  
  3880.  
  3881.  
  3882.  
  3883.  
  3884.  
  3885.  
  3886.  
  3887.  
  3888.  
  3889.  
  3890.  
  3891.  
  3892.  
  3893.  
  3894.  
  3895.  
  3896.  
  3897.  
  3898.  
  3899.  
  3900.  
  3901.                                       - 69 -
  3902.  
  3903.  
  3904.  
  3905.         ┌──────────────────────────────────────────────────────────────────┐
  3906.         │ Function 21: TOGGLE ANSI CODES                                   │
  3907.         └──────────────────────────────────────────────────────────────────┘
  3908.  
  3909.          DATA: <blank> or <parameter>
  3910.  
  3911.  
  3912.          Allows the user to choose ANSI graphics/colors or not.
  3913.  
  3914.          In the data field, you can enter these parameters:
  3915.  
  3916.            Ask       Will ask for new status
  3917.            On        Toggles option on
  3918.            Off       Toggles option off
  3919.            Toggle    Toggles option (reverse of current condition)
  3920.            Save      Save current status for this option
  3921.            Restore   Restore status saved by "Save"
  3922.            /Q        Quiet. Do not display "xxxx is now enabled/disabled"
  3923.  
  3924.          Example: "Ask /Q"
  3925.  
  3926.            This will ask the user if they want to enable or disable ANSI,
  3927.            and ProBoard will not display: "ANSI codes enabled/disabled".
  3928.  
  3929.  
  3930.          "Toggle" parameter.
  3931.  
  3932.  
  3933.         ┌──────────────────────────────────────────────────────────────────┐
  3934.         │ Function 22: CHECK FOR PERSONAL MAIL & FILES                     │
  3935.         └──────────────────────────────────────────────────────────────────┘
  3936.  
  3937.          DATA: <blank> or [/F] or [/M] or both.
  3938.  
  3939.  
  3940.          Searches all the message areas for messages addressed to the user
  3941.          that have not yet been received by him/her.  If ProBoard finds an
  3942.          area with new mail, which the user does not have read access to,
  3943.          it will inform the user, and the Sysop.
  3944.  
  3945.          This function also checks for personal files addressed to him/her.
  3946.  
  3947.          Specifying the [/F] option will force ProBoard to check only
  3948.          for new personal files.
  3949.  
  3950.          Specifying the [/M] option will force ProBoard to check only
  3951.          for new personal mail.
  3952.  
  3953.  
  3954.  
  3955.  
  3956.  
  3957.                                       - 70 -
  3958.  
  3959.  
  3960.  
  3961.         ┌──────────────────────────────────────────────────────────────────┐
  3962.         │ Function 23: READ MESSAGES                                       │
  3963.         └──────────────────────────────────────────────────────────────────┘
  3964.  
  3965.          DATA: <area> or <*> or <0>
  3966.  
  3967.  
  3968.          Allows the user to read a message.  If <area> is specified (a
  3969.          number ranging from 1 to 200), then only messages from message
  3970.          area <area> can be read.  If <*> is specified, only messages from
  3971.          the active area can be read (refer to the goto/gosub menu functions
  3972.          and to function 49).  If <0> is specified, only messages from areas
  3973.          selected in the combined boards can be read.  When reading messages
  3974.          in combined message areas, messages are read "per area", not in the
  3975.          order of the message number.
  3976.  
  3977.          The user has several options when reading messages:
  3978.  
  3979.             Forward        : First to last.
  3980.  
  3981.             Reverse        : Last to first.
  3982.  
  3983.             New            : New messages not read by the user.  Messages
  3984.                              are read per area.  If you have new messages
  3985.                              in Area 1 and 5, ProBoard will first show all
  3986.                              new messages in Area 1, then all new messages
  3987.                              in Area 5.
  3988.  
  3989.             Selected       : Messages selected by name or subject.
  3990.  
  3991.             Marked         : Marked messages only.
  3992.  
  3993.  
  3994.          When a message is read, the user has the following options:
  3995.  
  3996.             Next           : Next message.
  3997.  
  3998.             Previous       : Previous Message
  3999.  
  4000.             Again          : Show this message again.
  4001.  
  4002.             Stop           : Stop reading messages.
  4003.  
  4004.             Mark           : Mark this message for later use.
  4005.  
  4006.             Reply          : Reply to this message. The entire message will
  4007.                              be passed to the external fullscreen editor,
  4008.                              thus making it possible to quote text from the
  4009.                              original message in your reply.
  4010.  
  4011.  
  4012.  
  4013.                                       - 71 -
  4014.  
  4015.  
  4016.  
  4017.             Unread         : Set this messages status to 'Not received'.
  4018.                              Moves to the next message (if any).
  4019.  
  4020.             Delete         : Delete this message from the message base.
  4021.  
  4022.             Forward        : Copy the message and address it to somebody
  4023.                              else.  This will only work in a LOCAL message
  4024.                              area.
  4025.  
  4026.             Move           : Move this message to an other message area.
  4027.  
  4028.             Private        : Toggles the private/public status of the
  4029.                              message.
  4030.  
  4031.             Export         : Export this message to any file.
  4032.  
  4033.             + / -          : Show the next/previous message in the
  4034.                              reply-chain.
  4035.  
  4036.             Original       : Go back to the message where you first used
  4037.                              +/- to follow replies.
  4038.  
  4039.  
  4040.  
  4041.         ┌──────────────────────────────────────────────────────────────────┐
  4042.         │ Function 24: SCAN MESSAGES                                       │
  4043.         └──────────────────────────────────────────────────────────────────┘
  4044.  
  4045.          DATA: <area> or <*> or <0>
  4046.  
  4047.  
  4048.          Gives an overview of the messages. Only the message-header will
  4049.          be displayed, and the user has the possibility to mark messages
  4050.          for later retrieval. The options follow the same rules as in
  4051.          function 23 (Read messages).
  4052.  
  4053.  
  4054.  
  4055.         ┌──────────────────────────────────────────────────────────────────┐
  4056.         │ Function 25: QUICKSCAN MESSAGES                                  │
  4057.         └──────────────────────────────────────────────────────────────────┘
  4058.  
  4059.          DATA: <area>/<*>/<0>
  4060.  
  4061.  
  4062.          Same as the previous function, but only an overview in short form
  4063.          is displayed. The user does not have the possibility to mark
  4064.          messages. The options follow the same rules as in function 23
  4065.          (Read messages).
  4066.  
  4067.  
  4068.  
  4069.                                       - 72 -
  4070.  
  4071.  
  4072.  
  4073.         ┌──────────────────────────────────────────────────────────────────┐
  4074.         │ Function 26: USAGE GRAPH BY DAY (GRAPH)                          │
  4075.         └──────────────────────────────────────────────────────────────────┘
  4076.  
  4077.          DATA: -
  4078.  
  4079.  
  4080.          Displays a graph of your system's use for the last <xx> days.
  4081.          The parameter <xx> is determined by the setting in PROCFG, under
  4082.          Options (F1), System Options, # Usage Graph Days.
  4083.  
  4084.  
  4085.  
  4086.         ┌──────────────────────────────────────────────────────────────────┐
  4087.         │ Function 27: WRITE A MESSAGE                                     │
  4088.         └──────────────────────────────────────────────────────────────────┘
  4089.  
  4090.          DATA: <area> or <*> [/L]  [/T="<name of addressee>"]
  4091.  
  4092.  
  4093.          Allows the user to write a message. The area <area> (a number
  4094.          ranging from 1 to 200) can be replaced by <*> (refer to function 23).
  4095.  
  4096.          Optional parameters:
  4097.  
  4098.            /L      The user will be logged off after writing this message.
  4099.  
  4100.            /T      The destination (the addressee's name) is automatically
  4101.                    specified. It is not necessary to use quotes (") when
  4102.                    the username does not contain spaces.
  4103.  
  4104.           eg:     /T=Sysop           Writes a message to the sysop.
  4105.  
  4106.                   /T="Peter Piper"   Writes a message to Peter Piper.
  4107.  
  4108.          ProBoard's new "fuzzy search" will assist users who enter another
  4109.          users name improperly when they are writing messages in local
  4110.          areas.  ProBoard will search the user file, and give the user a
  4111.          choice of all users whose names are close to what they typed.
  4112.          Great for entering messages to users with uncommon names such as
  4113.          "Philippe Leybaert", etc.  ;-)
  4114.  
  4115.  
  4116.  
  4117.  
  4118.  
  4119.  
  4120.  
  4121.  
  4122.  
  4123.  
  4124.  
  4125.                                       - 73 -
  4126.  
  4127.  
  4128.  
  4129.         ┌──────────────────────────────────────────────────────────────────┐
  4130.         │ Function 28: COMBINED BOARDS SELECT                              │
  4131.         └──────────────────────────────────────────────────────────────────┘
  4132.  
  4133.          DATA: <blank> or [/M]
  4134.  
  4135.  
  4136.          Allows the user to select multiple message areas when using the
  4137.          'combined boards read/scan' function. This is useful when a user
  4138.          is not interested in certain message areas.
  4139.  
  4140.          Also allows users to select which areas ProBoard will check [/M]
  4141.          for new mail. This is very useful for visiting Sysops who don't
  4142.          want to be forced to read echomail they already received on their
  4143.          own system.
  4144.  
  4145.  
  4146.  
  4147.         ┌──────────────────────────────────────────────────────────────────┐
  4148.         │ Function 29: SYSTEM USAGE PER WEEK (GRAPH)                       │
  4149.         └──────────────────────────────────────────────────────────────────┘
  4150.  
  4151.          DATA: -
  4152.  
  4153.  
  4154.          Displays a graph of the system-usage in percent for the last 24
  4155.          weeks.
  4156.  
  4157.  
  4158.  
  4159.         ┌──────────────────────────────────────────────────────────────────┐
  4160.         │ Function 30: SHOW DIRECTORY                                      │
  4161.         └──────────────────────────────────────────────────────────────────┘
  4162.  
  4163.          DATA: [directoryname]
  4164.  
  4165.  
  4166.          Shows a list of all the files stored in the specified directory.
  4167.          If no directory is given, the user will be prompted for one.
  4168.  
  4169.  
  4170.  
  4171.  
  4172.  
  4173.  
  4174.  
  4175.  
  4176.  
  4177.  
  4178.  
  4179.  
  4180.  
  4181.                                       - 74 -
  4182.  
  4183.  
  4184.  
  4185.         ┌──────────────────────────────────────────────────────────────────┐
  4186.         │ Function 31: LIST FILES                                          │
  4187.         └──────────────────────────────────────────────────────────────────┘
  4188.  
  4189.          DATA: <area> or <X>
  4190.  
  4191.  
  4192.          Lists the files in the specified file area. If <X> was specified,
  4193.          the files in the active file area will be shown. The list of these
  4194.          files must be stored in a textfile created by the Sysop (refer to
  4195.          file area configuration). This textfile should contain the names
  4196.          and descriptions of the files. The description can be of any form
  4197.          you like.
  4198.  
  4199.          A line in the textfile should look like this:
  4200.  
  4201.          a) <filename> <blanks> <description>
  4202.  
  4203.              Filename + date + size + description will be displayed in the
  4204.              appropriate colors.
  4205.  
  4206.  
  4207.          b) <+> <description>
  4208.  
  4209.              The <+> will cause the description to be placed at the same
  4210.              horizontal cursor position and in the same color as the
  4211.              description from (a). This line will be displayed when
  4212.              searching for files.
  4213.  
  4214.  
  4215.          c) <!> <description>
  4216.  
  4217.              The description will be placed at the left of the screen, in
  4218.              the same color as the descriptions above. This line will be
  4219.              displayed when searching for files.
  4220.  
  4221.  
  4222.          d) <;> <description>
  4223.  
  4224.              Same as in (c), but the color is white.
  4225.  
  4226.          e) <description>
  4227.  
  4228.              Same as in (d), but this line will NOT be displayed when
  4229.              searching for files.
  4230.  
  4231.  
  4232.  
  4233.  
  4234.  
  4235.  
  4236.  
  4237.                                       - 75 -
  4238.  
  4239.  
  4240.  
  4241.          Example:
  4242.  
  4243.          =============================================================
  4244.          PB_122.ARJ ProBoard version 1.22
  4245.          +Best BBS program in the world
  4246.          !Original Belgian Product
  4247.          ;Flanders' Technology !!!
  4248.          =============================================================
  4249.  
  4250.          This will be output as:
  4251.  
  4252.          ============================================================= [c2]
  4253.          PB_122.ARJ   18/12/90 268583    ProBoard version 1.22         [c1]
  4254.                                          Best BBS program in the world [c1]
  4255.          Original Belgian Product                                      [c1]
  4256.          Flanders' Technology !!!                                      [c2]
  4257.          ============================================================= [c2]
  4258.  
  4259.          [c1] stands for color 1, [c2] stands for color 2.
  4260.  
  4261.          If a file area is configured as being CD-ROM, the file listing
  4262.          should look slightly different. Option (a) will become:
  4263.  
  4264.          a) <filename><blanks><date><blanks><filesize><blanks><description>
  4265.  
  4266.  
  4267.          There is one more thing you can do to make your file listings more
  4268.          colorful (previously undocumented) : Inserting Ctrl-A to Ctrl-G
  4269.          characters in your file listing will change the color to:
  4270.  
  4271.                 Ctrl-A   Red
  4272.                 Ctrl-B   Green
  4273.                 Ctrl-C   Yellow
  4274.                 Ctrl-D   Magenta
  4275.                 Ctrl-E   Blue
  4276.                 Ctrl-F   Cyan
  4277.                 Ctrl-G   White
  4278.  
  4279.  
  4280.  
  4281.  
  4282.  
  4283.  
  4284.  
  4285.  
  4286.  
  4287.  
  4288.  
  4289.  
  4290.  
  4291.  
  4292.  
  4293.                                       - 76 -
  4294.  
  4295.  
  4296.  
  4297.         ┌──────────────────────────────────────────────────────────────────┐
  4298.         │ Function 32: DOWNLOAD A FILE                                     │
  4299.         └──────────────────────────────────────────────────────────────────┘
  4300.  
  4301.          DATA: <area selection> or </A> or </F<filename>> or </P>
  4302.  
  4303.  
  4304.          Allows the user to download a file. The file areas a user can
  4305.          download from are defined by the area selection. This is a list
  4306.          of area-specifications, separated by blanks. Each specification
  4307.          has the form:
  4308.  
  4309.          [+]<area>
  4310.          <-><area>
  4311.  
  4312.          '+' stands for 'Include this area in the area-list', and is
  4313.              optional.
  4314.          '-' stands for 'Exclude this area from the area-list'.
  4315.  
  4316.          The parameter <area> should be one of the following:
  4317.  
  4318.             *               All areas.
  4319.             C               CD-ROM areas only.
  4320.             X               Currently active area.
  4321.             <n>             Area number <n>.
  4322.             <n1-n2>         Areas <n1> to <n2>.
  4323.  
  4324.          Examples:
  4325.  
  4326.             *               All areas
  4327.             * -C            All non-CD-ROM areas.
  4328.             * -3-9 +5       Areas 1,2,5,10,11,...
  4329.             X +2            Active area + area 2.
  4330.             C -2            All CD-ROM areas, except area 2
  4331.  
  4332.          Of course, a user must have the necessary download-rights in an
  4333.          area to be allowed to download files from it.
  4334.  
  4335.  
  4336.          You can also specify 3 other parameters:
  4337.  
  4338.            /A              Allows the user to download ANY file accessible
  4339.                            by DOS. When using this option, the full path
  4340.                            and filename must be specified. This option is
  4341.                            only intended for remote Sysops.
  4342.  
  4343.  
  4344.  
  4345.  
  4346.  
  4347.  
  4348.  
  4349.                                       - 77 -
  4350.  
  4351.  
  4352.  
  4353.            /F<filename>    The user will not be prompted for a file, but
  4354.                            the file <filename> will immediately be sent to
  4355.                            the user (useful for textfiles describing all
  4356.                            the files on the BBS).
  4357.                            Parameter <filename> should contain the full
  4358.                            pathname (eg. /FC:\PB\PB.DOC).
  4359.  
  4360.            /P              The user can only download personal files
  4361.                            addressed to him.
  4362.  
  4363.  
  4364.  
  4365.         ┌──────────────────────────────────────────────────────────────────┐
  4366.         │ Function 33: UPLOAD A FILE                                       │
  4367.         └──────────────────────────────────────────────────────────────────┘
  4368.  
  4369.          DATA: [directory] or [/P]
  4370.  
  4371.  
  4372.          Allows the user to upload a file to the BBS. If [directory] is
  4373.          specified, the upload will be placed in that directory. If not,
  4374.          it will be placed in the default upload-directory specified in
  4375.          PROCFG. (unregistered versions will always use the default
  4376.          upload directory).
  4377.          Upon successful reception of the file, the user will be prompted
  4378.          for a description of that file. The description can be several
  4379.          lines. If it begins with a '/', this description will be written
  4380.          to the file FILES.PVT in the upload-directory, else it will be
  4381.          written to the file FILES.BBS.
  4382.  
  4383.          If the data field contains "/P", the user can upload a personal
  4384.          file to another user. In this case the upload will be placed in
  4385.          the private upload directory (specified in ProCFG).
  4386.  
  4387.  
  4388.  
  4389.         ┌──────────────────────────────────────────────────────────────────┐
  4390.         │ Function 34: VIEW ARCHIVE                                        │
  4391.         └──────────────────────────────────────────────────────────────────┘
  4392.  
  4393.          DATA: <area selection>
  4394.  
  4395.  
  4396.          View the contents of a ZIP/LZH/ZOO/ARC/ARJ-file. The file
  4397.          specification input by the user will be looked for in the areas
  4398.          specified in <area selection>. Please refer to function 32
  4399.          (Download) for more information.
  4400.  
  4401.  
  4402.  
  4403.  
  4404.  
  4405.                                       - 78 -
  4406.  
  4407.  
  4408.  
  4409.         ┌──────────────────────────────────────────────────────────────────┐
  4410.         │ Function 35: KEYWORD SEARCH                                      │
  4411.         └──────────────────────────────────────────────────────────────────┘
  4412.  
  4413.          DATA: <area selection>
  4414.  
  4415.  
  4416.          Looks for a character string in the file descriptions. If the
  4417.          string is found, the related file and its description will be
  4418.          displayed. The character string will be looked for in the areas
  4419.          specified in <area selection>. Please refer to function 32
  4420.          (Download) for more information.
  4421.  
  4422.  
  4423.  
  4424.         ┌──────────────────────────────────────────────────────────────────┐
  4425.         │ Function 36: FILENAME SEARCH                                     │
  4426.         └──────────────────────────────────────────────────────────────────┘
  4427.  
  4428.          DATA: <area selection>
  4429.  
  4430.  
  4431.          Looks for a filename in the file listings (wildcards allowed).
  4432.          The filename will be looked for in the areas specified in
  4433.          <area selection>. Refer to function 32 (Download) for more
  4434.          information.
  4435.  
  4436.  
  4437.  
  4438.         ┌──────────────────────────────────────────────────────────────────┐
  4439.         │ Function 37: SHOW NEW FILES                                      │
  4440.         └──────────────────────────────────────────────────────────────────┘
  4441.  
  4442.          DATA: <area selection>
  4443.  
  4444.  
  4445.          Shows a list of files more recent than a date specified by the
  4446.          user. If the user does not specify a date, then that date will be
  4447.          the last time this user logged in. The files will be looked for
  4448.          in the areas specified in <area selection>. Please refer to
  4449.          function 32 (Download) for more information.
  4450.  
  4451.  
  4452.  
  4453.  
  4454.  
  4455.  
  4456.  
  4457.  
  4458.  
  4459.  
  4460.  
  4461.                                       - 79 -
  4462.  
  4463.  
  4464.  
  4465.         ┌──────────────────────────────────────────────────────────────────┐
  4466.         │ Function 38: VIEW A FILE                                         │
  4467.         └──────────────────────────────────────────────────────────────────┘
  4468.  
  4469.          DATA: <directory>
  4470.  
  4471.  
  4472.          This functions asks for a filename, and then looks for (and shows)
  4473.          the file stored in <directory>.
  4474.  
  4475.  
  4476.  
  4477.         ┌──────────────────────────────────────────────────────────────────┐
  4478.         │ Function 39: DISPLAY NAMED FILE                                  │
  4479.         └──────────────────────────────────────────────────────────────────┘
  4480.  
  4481.          DATA: <full filename>
  4482.  
  4483.  
  4484.          Displays a file to the user. The data field <full filename> must
  4485.          contain path, name and extension.
  4486.  
  4487.  
  4488.  
  4489.         ┌──────────────────────────────────────────────────────────────────┐
  4490.         │ Function 40: DISPLAY ANS/ASC FILE WITH MENU HOTKEYS              │
  4491.         └──────────────────────────────────────────────────────────────────┘
  4492.  
  4493.          DATA: <filename without extension>
  4494.  
  4495.  
  4496.          This function is the same as function 5, but can only be used in
  4497.          'autoexec-menus', because it shows an ANS/ASC-file AND checks for
  4498.          menu hotkeys at the same time. Please refer to the section about
  4499.          menus for more information about the autoexec-concept.
  4500.  
  4501.  
  4502.  
  4503.  
  4504.  
  4505.  
  4506.  
  4507.  
  4508.  
  4509.  
  4510.  
  4511.  
  4512.  
  4513.  
  4514.  
  4515.  
  4516.  
  4517.                                       - 80 -
  4518.  
  4519.  
  4520.  
  4521.         ┌──────────────────────────────────────────────────────────────────┐
  4522.         │ Function 41: TOGGLE FULLSCREEN EDITOR                            │
  4523.         └──────────────────────────────────────────────────────────────────┘
  4524.  
  4525.          DATA: <blank> or <parameter>
  4526.  
  4527.  
  4528.          Lets the user decide whether they want to use ProBoard's line
  4529.          editor or the (external) fullscreen editor.
  4530.  
  4531.          In the data field, you can enter these parameters:
  4532.  
  4533.            Ask       Will ask for new status
  4534.            On        Toggles option on
  4535.            Off       Toggles option off
  4536.            Toggle    Toggles option (reverse of current condition)
  4537.            Save      Save current status for this option
  4538.            Restore   Restore status saved by "Save"
  4539.            /Q        Quiet. Do not display "xxxx is now enabled/disabled"
  4540.  
  4541.          Example: "Ask /Q"
  4542.  
  4543.            This will ask the user if they want to enable or disable the
  4544.            full screen (external) editor, and ProBoard will not display:
  4545.            "Full Screen editor is now enabled/disabled".
  4546.  
  4547.  
  4548.          "Toggle" parameter.
  4549.  
  4550.  
  4551.  
  4552.         ┌──────────────────────────────────────────────────────────────────┐
  4553.         │ Function 42: TOGGLE COMMAND STACKING                             │
  4554.         └──────────────────────────────────────────────────────────────────┘
  4555.  
  4556.          DATA: -
  4557.  
  4558.  
  4559.          Lets the user decide whether he will work with hotkeys or with
  4560.          combinations of hotkeys and command stacking (à la Opus). The
  4561.          command stack execution is initiated by pressing <Enter>.
  4562.          A ';' in the command stack will be replaced by <Enter>.
  4563.  
  4564.          Eg.  M1WSysop;Subject;Y
  4565.  
  4566.          This would write a private message in message area 1 to the Sysop,
  4567.          with subject "Subject".
  4568.  
  4569.  
  4570.  
  4571.  
  4572.  
  4573.                                       - 81 -
  4574.  
  4575.  
  4576.  
  4577.         ┌──────────────────────────────────────────────────────────────────┐
  4578.         │ Function 43: CLEAR MARKED MESSAGES                               │
  4579.         └──────────────────────────────────────────────────────────────────┘
  4580.  
  4581.          DATA: -
  4582.  
  4583.  
  4584.          Clears all marked messages.
  4585.  
  4586.  
  4587.  
  4588.         ┌──────────────────────────────────────────────────────────────────┐
  4589.         │ Function 44: GLOBAL COMBINED BOARDS SELECTION                    │
  4590.         └──────────────────────────────────────────────────────────────────┘
  4591.  
  4592.          DATA: -
  4593.  
  4594.  
  4595.          Allows the user to select or unselect all areas in his combined
  4596.          boards selection.
  4597.  
  4598.  
  4599.  
  4600.         ┌──────────────────────────────────────────────────────────────────┐
  4601.         │ Function 45: DISPLAY TEXTFILE & WAIT                             │
  4602.         └──────────────────────────────────────────────────────────────────┘
  4603.  
  4604.          DATA: <full filename>
  4605.  
  4606.  
  4607.          Displays a textfile to the user, then waits for the user to press
  4608.          <Enter>. The filename requires full path, name and extension.
  4609.  
  4610.  
  4611.  
  4612.         ┌──────────────────────────────────────────────────────────────────┐
  4613.         │ Function 46: CHANGE USER LEVEL AND/OR FLAGS                      │
  4614.         └──────────────────────────────────────────────────────────────────┘
  4615.  
  4616.          DATA: [level] [flag +/-] [flag +/-] ...
  4617.  
  4618.  
  4619.          Changes a user's level and/or flags. [level] can occur only once
  4620.          in the parameter array, flags can be toggled on/off by specifying
  4621.          the flag, followed by +/-.
  4622.  
  4623.          Data example:   10 A+ 3-
  4624.  
  4625.          This would set the user's level to 10, set flag A and clear flag 3.
  4626.  
  4627.  
  4628.  
  4629.                                       - 82 -
  4630.  
  4631.  
  4632.  
  4633.         ┌──────────────────────────────────────────────────────────────────┐
  4634.         │ Function 47: MAKE A LOG ENTRY                                    │
  4635.         └──────────────────────────────────────────────────────────────────┘
  4636.  
  4637.          DATA: <log entry>
  4638.  
  4639.  
  4640.          Writes <log entry> to PROBOARD.LOG, thus allowing the Sysop to
  4641.          customize his log.
  4642.  
  4643.  
  4644.  
  4645.         ┌──────────────────────────────────────────────────────────────────┐
  4646.         │ Function 48: SHOW HITPARADE                                      │
  4647.         └──────────────────────────────────────────────────────────────────┘
  4648.  
  4649.          DATA: <Mn>/<Kn>/<Tn>/<Un>/<Fn>/<Cn>/<On>
  4650.  
  4651.  
  4652.          This functions returns an overview of the most active users in
  4653.          several fields.
  4654.  
  4655.          The 'n' with the parameters stands for the number of users to be
  4656.          displayed in the hitparade. (unregistered versions default to 5)
  4657.  
  4658.             M   Best message-writers
  4659.  
  4660.             K   Best downloaders (Kb)
  4661.  
  4662.             T   Best downloaders (# downloads)
  4663.  
  4664.             U   Best uploaders (Kb)
  4665.  
  4666.             F   Best uploaders (# uploads)
  4667.  
  4668.             C   Best callers (# times called)
  4669.  
  4670.             O   Total time online
  4671.  
  4672.          Data example:   U15
  4673.  
  4674.  
  4675.  
  4676.  
  4677.  
  4678.  
  4679.  
  4680.  
  4681.  
  4682.  
  4683.  
  4684.  
  4685.                                       - 83 -
  4686.  
  4687.  
  4688.  
  4689.         ┌──────────────────────────────────────────────────────────────────┐
  4690.         │ Function 49: SELECT MESSAGE AREA                                 │
  4691.         └──────────────────────────────────────────────────────────────────┘
  4692.  
  4693.          DATA: <area selection>
  4694.  
  4695.          Lets the user select a new message area.  This function is to be
  4696.          used in cooperation with other message-related functions.
  4697.  
  4698.          Valid area selection parameters are:
  4699.  
  4700.            X          Current Area
  4701.            E          All Echo Areas
  4702.            N          All NetMail Areas
  4703.            L          All Local Areas
  4704.            *          All Areas
  4705.            <n>        Area #<n>
  4706.            <n1>-<n2>  Areas #<n1> to #<n2>
  4707.  
  4708.          Examples:       * -E          All non-echomail areas
  4709.                          1-20 50-60    Areas 1..20 and 50..60
  4710.                          N 10-20 -15   All netmail areas, plus areas 10..20,
  4711.                                        except area #15
  4712.  
  4713.          Note: Since ProBoard parses only the first letter of an alpha area
  4714.          selection, the keywords from prior versions, [Local / Net / Echo]
  4715.          can still be used and will still work.  It is recommended however,
  4716.          that you change to the new 1.22 parameter(s) since the keywords
  4717.          [Local / Net / Echo] may not be supported in upcoming versions.
  4718.  
  4719.  
  4720.  
  4721.         ┌──────────────────────────────────────────────────────────────────┐
  4722.         │ Function 50: SHOW USERS ONLINE                                   │
  4723.         └──────────────────────────────────────────────────────────────────┘
  4724.  
  4725.          DATA: -
  4726.  
  4727.  
  4728.          Displays who is online on the other nodes. Of course, you
  4729.          understand that this function is useful only on multi-user systems.
  4730.          To protect the Sysop's health, it is possible not to show the
  4731.          Sysop's name here (Refer to the ProCFG section).
  4732.  
  4733.  
  4734.  
  4735.  
  4736.  
  4737.  
  4738.  
  4739.  
  4740.  
  4741.                                       - 84 -
  4742.  
  4743.  
  4744.  
  4745.         ┌──────────────────────────────────────────────────────────────────┐
  4746.         │ Function 51: LIST LAST CALLERS                                   │
  4747.         └──────────────────────────────────────────────────────────────────┘
  4748.  
  4749.          DATA: <number of users to be displayed>
  4750.  
  4751.  
  4752.          Gives an overview of the users that have most recently logged in
  4753.          (for ALL the nodes). In the non-registered version, the number
  4754.          of users shown is forced to 5.
  4755.  
  4756.  
  4757.  
  4758.         ┌──────────────────────────────────────────────────────────────────┐
  4759.         │ Function 52: REMOTE USER EDITOR                                  │
  4760.         └──────────────────────────────────────────────────────────────────┘
  4761.  
  4762.          DATA: -
  4763.  
  4764.  
  4765.          Allows you to adjust a user's level (or even delete him), without
  4766.          you having to be at the computer (VERY handy for co-Sysops!).
  4767.  
  4768.  
  4769.  
  4770.         ┌──────────────────────────────────────────────────────────────────┐
  4771.         │ Function 53: MULTILINE CHAT (INTERNODE CHAT)                     │
  4772.         └──────────────────────────────────────────────────────────────────┘
  4773.  
  4774.          DATA: -
  4775.  
  4776.  
  4777.          This is certainly the nicest function in ProBoard! This function
  4778.          allows two users on different nodes to chat with each other
  4779.          IN REAL TIME!!! You will actually see the other user type
  4780.          (mistakes?), as if you were in chat-mode with the Sysop. This is
  4781.          UNlike other systems, where entire LINES are sent to the other
  4782.          node.
  4783.  
  4784.          User A on node X will have to specify the node he wants to chat
  4785.          with, whereafter user B on node Y will be prompted if he wants
  4786.          to chat.
  4787.  
  4788.          It is VERY (!VERY!) important that your system supports full file
  4789.          & record locking to use this option. When you are not running a
  4790.          LAN, you MUST install SHARE.EXE! ProBoard will definitely lock up
  4791.          when SHARE.EXE is not installed on a stand-alone system.
  4792.  
  4793.  
  4794.  
  4795.  
  4796.  
  4797.                                       - 85 -
  4798.  
  4799.  
  4800.  
  4801.         ┌──────────────────────────────────────────────────────────────────┐
  4802.         │ Function 54: SELECT FILE AREA                                    │
  4803.         └──────────────────────────────────────────────────────────────────┘
  4804.  
  4805.          DATA: <area selection>
  4806.  
  4807.  
  4808.          Lets the user select a new file area. This function is to be used
  4809.          in cooperation with other file-related functions. Refer to
  4810.          functions 1 and 32 for more information.
  4811.  
  4812.  
  4813.  
  4814.         ┌──────────────────────────────────────────────────────────────────┐
  4815.         │ Function 55: SHOW .GIF FILE INFO                                 │
  4816.         └──────────────────────────────────────────────────────────────────┘
  4817.  
  4818.          DATA: <area selection>
  4819.  
  4820.  
  4821.          Prompts the user for a .GIF-filename (wildcards allowed) and
  4822.          displays resolution and number of colors for the file(s). The
  4823.          files will be looked for in <area selection>. Refer to function 32
  4824.          (Download) for more information.
  4825.  
  4826.  
  4827.  
  4828.         ┌──────────────────────────────────────────────────────────────────┐
  4829.         │ Function 56: TOGGLE IBM CHARACTERS                               │
  4830.         └──────────────────────────────────────────────────────────────────┘
  4831.  
  4832.          DATA: -
  4833.  
  4834.  
  4835.          Allows the user to disable/enable extended IBM characters. When
  4836.          disabled, all IBM-specific characters are converted to standard
  4837.          ASCII characters ("+-|")
  4838.  
  4839.  
  4840.  
  4841.         ┌──────────────────────────────────────────────────────────────────┐
  4842.         │ Function 57: CHANGE PHONE NUMBER                                 │
  4843.         └──────────────────────────────────────────────────────────────────┘
  4844.  
  4845.          DATA: -
  4846.  
  4847.  
  4848.          Allows the user to change his phone number stored in his user
  4849.          record.
  4850.  
  4851.  
  4852.  
  4853.                                       - 86 -
  4854.  
  4855.  
  4856.  
  4857.         ┌──────────────────────────────────────────────────────────────────┐
  4858.         │ Function 58: CHANGE DATA/FAX PHONE NUMBER                        │
  4859.         └──────────────────────────────────────────────────────────────────┘
  4860.  
  4861.          DATA: -
  4862.  
  4863.  
  4864.          Allows the user to change his data/fax phone number stored in his
  4865.          user record.
  4866.  
  4867.  
  4868.  
  4869.         ┌──────────────────────────────────────────────────────────────────┐
  4870.         │ Function 59: CHANGE USER ALIAS                                   │
  4871.         └──────────────────────────────────────────────────────────────────┘
  4872.  
  4873.          DATA: -
  4874.  
  4875.  
  4876.          Allows the user to change his alias. It is not allowed to use an
  4877.          alias that is being used by another user.
  4878.  
  4879.  
  4880.  
  4881.         ┌──────────────────────────────────────────────────────────────────┐
  4882.         │ Function 60: RUN PROBOARD SDK FILE                               │
  4883.         └──────────────────────────────────────────────────────────────────┘
  4884.  
  4885.          DATA: <program> [data]
  4886.  
  4887.  
  4888.          Loads & executes a ProBoard Executable (PEX file) created using
  4889.          the ProBoard Software Development Kit (SDK).  The PEX file must
  4890.          reside in the PEX-directory (Specified in ProCFG).
  4891.  
  4892.  
  4893.  
  4894.  
  4895.  
  4896.  
  4897.  
  4898.  
  4899.  
  4900.  
  4901.  
  4902.  
  4903.  
  4904.  
  4905.  
  4906.  
  4907.  
  4908.  
  4909.                                       - 87 -
  4910.  
  4911.  
  4912.  
  4913.         ┌──────────────────────────────────────────────────────────────────┐
  4914.         │ Function 61: BULLETIN MENU                                       │
  4915.         └──────────────────────────────────────────────────────────────────┘
  4916.  
  4917.          DATA: <filename> [prompt]
  4918.  
  4919.  
  4920.          Displays <filename>.ANS/ASC (like function 5), and prompts the
  4921.          user for a file suffix. This suffix is appended to <filename>, and
  4922.          the file with the resulting filename is displayed. Obviously,
  4923.          <filename> should not be longer than 7 characters.
  4924.          The optional [prompt] parameters defines a prompt to be shown to
  4925.          the user. For example: Enter a bulletin.
  4926.  
  4927.          Data example: BULLET Enter a bulletin:
  4928.  
  4929.  
  4930.  
  4931.         ┌──────────────────────────────────────────────────────────────────┐
  4932.         │ Function 62: TOGGLE AVATAR/0                                     │
  4933.         └──────────────────────────────────────────────────────────────────┘
  4934.  
  4935.          DATA: <blank> or <parameter>
  4936.  
  4937.  
  4938.          Allows the user to toggle AVATAR/0 on/off in their user record.
  4939.  
  4940.          In the data field, you can enter these parameters:
  4941.  
  4942.            Ask       Will ask for new status
  4943.            On        Toggles option on
  4944.            Off       Toggles option off
  4945.            Toggle    Toggles option (reverse of current condition)
  4946.            Save      Save current status for this option
  4947.            Restore   Restore status saved by "Save"
  4948.            /Q        Quiet. Do not display "xxxx is now enabled/disabled"
  4949.  
  4950.          Example: "Ask /Q"
  4951.  
  4952.            This will ask the user if they want to enable or disable AVATAR/0
  4953.            screen display codes, and ProBoard will not display: "Avatar
  4954.            codes are now enabled/disabled".
  4955.  
  4956.  
  4957.          "Toggle" parameter.
  4958.  
  4959.  
  4960.  
  4961.  
  4962.  
  4963.  
  4964.  
  4965.                                       - 88 -
  4966.  
  4967.  
  4968.  
  4969.         ┌──────────────────────────────────────────────────────────────────┐
  4970.         │ Function 63: TOGGLE AVATAR/0+                                    │
  4971.         └──────────────────────────────────────────────────────────────────┘
  4972.  
  4973.          DATA: <blank> or <parameter>
  4974.  
  4975.  
  4976.          Allows the user to toggle AVATAR/0+ on/off in their user record.
  4977.  
  4978.          In the data field, you can enter these parameters:
  4979.  
  4980.            Ask       Will ask for new status
  4981.            On        Toggles option on
  4982.            Off       Toggles option off
  4983.            Toggle    Toggles option (reverse of current condition)
  4984.            Save      Save current status for this option
  4985.            Restore   Restore status saved by "Save"
  4986.            /Q        Quiet. Do not display "xxxx is now enabled/disabled"
  4987.  
  4988.          Example: "Ask /Q"
  4989.  
  4990.            This will ask the user if they want to enable or disable
  4991.            AVATAR/0+ screen display codes, and ProBoard will not
  4992.            display: "AVT/0+ codes are now enabled/disabled".
  4993.  
  4994.  
  4995.          "Toggle" parameter.
  4996.  
  4997.  
  4998.  
  4999.  
  5000.  
  5001.  
  5002.  
  5003.  
  5004.  
  5005.  
  5006.  
  5007.  
  5008.  
  5009.  
  5010.  
  5011.  
  5012.  
  5013.  
  5014.  
  5015.  
  5016.  
  5017.  
  5018.  
  5019.  
  5020.  
  5021.                                       - 89 -
  5022.  
  5023.  
  5024.  
  5025.         ╒══════════════════════════════════════════════════════════════════╕
  5026.         │░░░░░░ USERS ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  5027.         ╘══════════════════════════════════════════════════════════════════╛
  5028.  
  5029.  
  5030.          The file USERS.BBS contains all the data about the users, such as
  5031.          level, number of times called, combined boards access, messages
  5032.          last read, etc. Use ProBoard's User Editor to add/edit/delete
  5033.          users in the USERS.BBS file.  If you delete users you must
  5034.          run PBUTIL [UK].  More info on this in the section on PBUTIL.
  5035.  
  5036.  
  5037.  
  5038.         ┌──────────────────────────────────────────────────────────────────┐
  5039.         │ Log Levels                                                       │
  5040.         └──────────────────────────────────────────────────────────────────┘
  5041.  
  5042.  
  5043.          Each user has a certain loglevel, to determine how information
  5044.          about that user will be written to ProBoard's log (PROBOARD.LOG).
  5045.  
  5046.          This can be useful if you suspect a user of logging in using 2
  5047.          different names. If you give those users a higher log level, you
  5048.          can track their behaviour.
  5049.  
  5050.          The following levels are possible:
  5051.  
  5052.              Friend          * NOTHING BUT login, logoff and errors
  5053.                                will be logged.
  5054.  
  5055.              Normal          * Login
  5056.                              * Logoff
  5057.                              * Errors
  5058.                              * Writing Sysop messages
  5059.                              * Sysop paging
  5060.                              * Downloads
  5061.                              * Uploads
  5062.                              * Questionnaires
  5063.  
  5064.              Suspicious      * Everything from 'Normal'
  5065.                              * Reading messages
  5066.                              * Hitparades
  5067.                              * Last callers
  5068.                              * Graphics
  5069.  
  5070.              Dangerous       * Everything from 'Suspicious'
  5071.                              * ALL the movements between menus (this can
  5072.                                make the logfile HUGE)
  5073.  
  5074.  
  5075.  
  5076.  
  5077.                                       - 90 -
  5078.  
  5079.  
  5080.  
  5081.         ╒══════════════════════════════════════════════════════════════════╕
  5082.         │░░░░░░ ECHOMAIL & NETMAIL ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  5083.         ╘══════════════════════════════════════════════════════════════════╛
  5084.  
  5085.  
  5086.          ProBoard fully supports Echomail and Netmail, according to the
  5087.          FTSC (FidoNet Technical Standards Committee) specifications.
  5088.  
  5089.  
  5090.  
  5091.         ┌──────────────────────────────────────────────────────────────────┐
  5092.         │ Echomail                                                         │
  5093.         └──────────────────────────────────────────────────────────────────┘
  5094.  
  5095.          When a user enters a message in a message area configured as an
  5096.          Echomail area, an origin line will be added to that message. This
  5097.          origin line is obtained from the message area's configuration. If
  5098.          there is no origin line specified for this message area, the
  5099.          default origin line will be used.  The default origin line is
  5100.          specified in PROCFG under Options (F1) - Site Info, in the field
  5101.          "Default Origin Line".
  5102.  
  5103.          To import/export Echomail, you need an Echomail processor. No
  5104.          such program is included, but as ProBoard uses the Hudson
  5105.          message-base structure, a large number of Echomail processors
  5106.          are available.
  5107.  
  5108.          Great echomail-processors compatible with ProBoard are:
  5109.  
  5110.             - QEcho
  5111.             - ZmailH
  5112.             - TosScan
  5113.             - GECHO
  5114.  
  5115.  
  5116.         ┌──────────────────────────────────────────────────────────────────┐
  5117.         │ Netmail                                                          │
  5118.         └──────────────────────────────────────────────────────────────────┘
  5119.  
  5120.          A Netmail message (in short: Netmail) is a message that has a
  5121.          fixed destination within the network. This destination is
  5122.          defined by a node-number of the form "Zone:Net/Node.Point".
  5123.          ProBoard will first find out whether this address exists, and
  5124.          will then (if it exists) tell you the name of the node where
  5125.          the Netmail is to be sent to.
  5126.  
  5127.          When entering a node number in ProBoard, it is possible to look
  5128.          up the nodes you want by entering a '?'.
  5129.  
  5130.  
  5131.  
  5132.  
  5133.                                       - 91 -
  5134.  
  5135.  
  5136.  
  5137.          eg:   ?        Shows a list of all zones.
  5138.                2:?      Shows a list of all nets and regions in zone 2.
  5139.                2:292/?  Shows a list of all nodes in net 2:292/
  5140.  
  5141.          ProBoard needs a nodelist to use Netmail. This nodelist is
  5142.          usually available on every node in the network. ProBoard
  5143.          generates an index file for its own use (NODE_IDX.PRO) by running
  5144.          PBUTIL NC.
  5145.  
  5146.          For more information about PBUTIL's NC-option, please refer to the
  5147.          section on PBUTIL.
  5148.  
  5149.          To import and export Netmail, you need an external utility like
  5150.          MAILSCAN ,MBUTIL or ZmailH.
  5151.  
  5152.  
  5153.  
  5154.  
  5155.  
  5156.  
  5157.  
  5158.  
  5159.  
  5160.  
  5161.  
  5162.  
  5163.  
  5164.  
  5165.  
  5166.  
  5167.  
  5168.  
  5169.  
  5170.  
  5171.  
  5172.  
  5173.  
  5174.  
  5175.  
  5176.  
  5177.  
  5178.  
  5179.  
  5180.  
  5181.  
  5182.  
  5183.  
  5184.  
  5185.  
  5186.  
  5187.  
  5188.  
  5189.                                       - 92 -
  5190.  
  5191.  
  5192.  
  5193.         ╒═════════════════════════════════════════════════════════════════╕
  5194.         │░░░░░░ PBUTIL ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  5195.         ╘═════════════════════════════════════════════════════════════════╛
  5196.  
  5197.  
  5198.          PBUtil is an extra utility provided with the ProBoard package.
  5199.          It performs all of the maintenance your ProBoard system needs.
  5200.  
  5201.          PBUtil is called with a parameter specifying the operation to be
  5202.          executed:
  5203.  
  5204.  
  5205.          PBUTIL <operation> [option]
  5206.  
  5207.             Operations:  MP    Message Packer
  5208.                          MI    Message Indexer
  5209.                          ML    Message Linker
  5210.                          UF    Userfile Fixer
  5211.                          UP    Userfile Packer
  5212.                          UK    User Killer
  5213.                          UI    Userfile Indexer
  5214.                          FC    File Counters
  5215.                          NC    Nodelist Compiler
  5216.                          MU    Music player
  5217.  
  5218.          PBUtil can be run from any directory provided that it (PBUTIL)
  5219.          is found in your DOS path.  Refer to your DOS manual for more
  5220.          information on the PATH statement.
  5221.  
  5222.  
  5223.  
  5224.  
  5225.  
  5226.  
  5227.  
  5228.  
  5229.  
  5230.  
  5231.  
  5232.  
  5233.  
  5234.  
  5235.  
  5236.  
  5237.  
  5238.  
  5239.  
  5240.  
  5241.  
  5242.  
  5243.  
  5244.  
  5245.                                       - 93 -
  5246.  
  5247.  
  5248.  
  5249.         ┌──────────────────────────────────────────────────────────────────┐
  5250.         │ [MP] Message Packer                                              │
  5251.         └──────────────────────────────────────────────────────────────────┘
  5252.  
  5253.          Packs the message base.  This means that the deleted messages are
  5254.          effectively removed from the message base.
  5255.  
  5256.          Specifying option -R will instruct the message packer to renumber
  5257.          the message base.  Renumbering the message base is done
  5258.          automatically when the highest message number exceeds 25000.
  5259.  
  5260.          Option -F forces the pack to be executed, even if there are no
  5261.          deleted messages.
  5262.  
  5263.          Option -K will delete the .BAK files created when packing the
  5264.          message base.
  5265.  
  5266.          Option -D will remove old messages. Check the section about 
  5267.          the message areas for more information.
  5268.  
  5269.          Lastread-pointers in the userfile will be adjusted when
  5270.          renumbering.
  5271.  
  5272.          Do NOT pack the messagebase when a user is online!!
  5273.          ───────────────────────────────────────────────────
  5274.  
  5275.  
  5276.         ┌──────────────────────────────────────────────────────────────────┐
  5277.         │ [MI] Message Indexer                                             │
  5278.         └──────────────────────────────────────────────────────────────────┘
  5279.  
  5280.          Recreates the message base index files. (MSGIDX.BBS,MSGTOIDX.BBS
  5281.          and MSGINFO.BBS).
  5282.  
  5283.  
  5284.  
  5285.         ┌──────────────────────────────────────────────────────────────────┐
  5286.         │ [ML] Message Linker                                              │
  5287.         └──────────────────────────────────────────────────────────────────┘
  5288.  
  5289.          Completely rebuilds reply chains in all areas. This operation has
  5290.          to be performed when echomail is imported into the message base 
  5291.          and after using the message packer with the -D parameter.
  5292.  
  5293.  
  5294.  
  5295.  
  5296.  
  5297.  
  5298.  
  5299.  
  5300.  
  5301.                                       - 94 -
  5302.  
  5303.  
  5304.  
  5305.         ┌──────────────────────────────────────────────────────────────────┐
  5306.         │ [UP] UserFile Packer                                             │
  5307.         └──────────────────────────────────────────────────────────────────┘
  5308.  
  5309.          Removes all deleted users from USERS.BBS, except the users with
  5310.          the NoKill flag set. Corrupted user records are also removed.
  5311.  
  5312.          Specifying option -R instructs the user packer to reset all
  5313.          Last Read pointers to zero.
  5314.  
  5315.          Specifying option -K will delete the .BAK file created when packing
  5316.          the user file.
  5317.  
  5318.          Do NOT pack the userfile when a user is online!!
  5319.          ────────────────────────────────────────────────
  5320.  
  5321.  
  5322.         ┌──────────────────────────────────────────────────────────────────┐
  5323.         │ [UI] UserFile Indexer                                            │
  5324.         └──────────────────────────────────────────────────────────────────┘
  5325.  
  5326.          Creates an index for the user file.  ProBoard uses this index
  5327.          file to search in the user file.  This greatly reduces the time
  5328.          needed to locate a user at login.
  5329.  
  5330.  
  5331.  
  5332.         ┌──────────────────────────────────────────────────────────────────┐
  5333.         │ [UF] UserFile Fixer                                              │
  5334.         └──────────────────────────────────────────────────────────────────┘
  5335.  
  5336.          Run this after you use a user file packer/sorter from another
  5337.          source (like RAUSER or RACE).  It assures that the extensions in
  5338.          ProBoard's user file are updated properly.
  5339.  
  5340.  
  5341.  
  5342.  
  5343.  
  5344.  
  5345.  
  5346.  
  5347.  
  5348.  
  5349.  
  5350.  
  5351.  
  5352.  
  5353.  
  5354.  
  5355.  
  5356.  
  5357.                                       - 95 -
  5358.  
  5359.  
  5360.  
  5361.         ┌──────────────────────────────────────────────────────────────────┐
  5362.         │ [UK] UserFile Killer                                             │
  5363.         └──────────────────────────────────────────────────────────────────┘
  5364.  
  5365.          Deletes (kills) certain users from USERS.BBS.  The criteria are:
  5366.          not having called for a certain number of days, less than a certain
  5367.          number of times called, or a combination of these two.
  5368.  
  5369.          Parameters to use:
  5370.  
  5371.              -D<# of days>   Removes all users that haven't called for
  5372.                              <# of days>.
  5373.  
  5374.              -C<calls>       Removes all users that have called less than
  5375.                              <calls> times.
  5376.  
  5377.          Combining these two parameters, will remove all users that have
  5378.          called less than <calls> times and haven't called for <# of days>.
  5379.          This option comes in handy to remove all users that have called
  5380.          just once, but without removing your new users!
  5381.  
  5382.          Examples:
  5383.  
  5384.             PBUTIL UK -C3           Removes all users that have called only
  5385.                                     1 or 2 times.
  5386.  
  5387.             PBUTIL UK -D365         Removes all users that haven't called
  5388.                                     for the last 365 days.
  5389.  
  5390.             PBUTIL UK -C2 -D100     Removes all users that have called
  5391.                                     less than 2 times, and removes users
  5392.                                     that haven't called in the last 100
  5393.                                     days. "No-Kill" flags in User Records
  5394.                                     will be honored.
  5395.  
  5396.  
  5397.  
  5398.  
  5399.  
  5400.  
  5401.  
  5402.  
  5403.  
  5404.  
  5405.  
  5406.  
  5407.  
  5408.  
  5409.  
  5410.  
  5411.  
  5412.  
  5413.                                       - 96 -
  5414.  
  5415.  
  5416.  
  5417.         ┌──────────────────────────────────────────────────────────────────┐
  5418.         │ [FC] File Counters                                               │
  5419.         └──────────────────────────────────────────────────────────────────┘
  5420.  
  5421.          After each download, ProBoard adds a line to the file DOWNLOAD.LOG.
  5422.          This file's only purpose is to be used by the FC module of PBUtil.
  5423.          FC reads the file DOWNLOAD.LOG and updates file counters in every
  5424.          file listing, to keep up with the number of times every file
  5425.          has been downloaded.
  5426.  
  5427.          Specifying option -N<xx> instructs PBUtil to create a list of the
  5428.          top-xx downloaded files. This list is named TOPFILES.A?? and
  5429.          is stored in the textfiles-subdirectory. The number of files to be
  5430.          written in this list is <xx>, (eg. -N15).
  5431.  
  5432.          Specifying option -F instructs PBUtil to ALWAYS create
  5433.          TOPFILES.ASC/ANS/AVT/AVP, even if DOWNLOAD.LOG is empty or
  5434.          doesn't exist.
  5435.  
  5436.          Option -R rewrites all file listings with the appropriate file
  5437.          count added to each file. This is useful when you have added some
  5438.          new files.
  5439.  
  5440.          The file counters will be placed before the description of the
  5441.          files.
  5442.  
  5443.          Eg. PB_122.ARJ  [89]  Superb new BBS program from Belgium !!!!
  5444.                          ^^^^
  5445.                      File Counter - shows how many times file has been
  5446.                                     downloaded.
  5447.  
  5448.         You can create a file called NOTOPS.CTL to exclude files from being
  5449.         included when the TOPFILES.A?? is created.  The format of this file
  5450.         is just <filename>.<extension>  Example as follows:
  5451.  
  5452.         BLACK.ZIP
  5453.         NOWAY.EXE
  5454.         RA_111.ARJ
  5455.  
  5456.  
  5457.  
  5458.         ┌──────────────────────────────────────────────────────────────────┐
  5459.         │ [NC] Nodelist Compiler                                           │
  5460.         └──────────────────────────────────────────────────────────────────┘
  5461.  
  5462.          Reads a FidoNet-compatible nodelist and creates a ProBoard index-
  5463.          file (NODE_IDX.PRO) in the system directory. This file will be
  5464.          less than 10K in size, but your original nodelist has to stay in
  5465.          the nodelist directory.
  5466.  
  5467.  
  5468.  
  5469.                                       - 97 -
  5470.  
  5471.  
  5472.  
  5473.          The compiler will look for the latest standard nodelist
  5474.          (NODELIST.xxx) in your nodelist directory.
  5475.  
  5476.          Specifying extra files as parameters instructs the nodelist
  5477.          compiler to compile extra nodelists. Several extra nodelists can
  5478.          be given as parameters. If you don't specify an extension, ProBoard
  5479.          will look for the latest file with extension .nnn (nnn=day number).
  5480.          If you want to compile a file without an extension, use <FILE>.
  5481.  
  5482.            Eg. PBUTIL NC MYNL MYLIST. FDNET.PVT
  5483.  
  5484.          This would compile the latest NODELIST.nnn, the latest MYNL.nnn,
  5485.          MYLIST and FDNET.PVT in the standard nodelist directory.
  5486.  
  5487.          To determine the costs of sending Netmail, a textfile will be read
  5488.          that you will have to create. This textfile is called COST.PRO and
  5489.          should be in ProBoard's system directory. The lines in this file
  5490.          have the following format:
  5491.  
  5492.              <Command> <Param1> [Param2]
  5493.  
  5494.  
  5495.          Commands:
  5496.  
  5497.          MYZONE <zone>                 All commands after this command act
  5498.                                        on zone <zone>. You need at least
  5499.                                        1 MYZONE command. If not, ProBoard
  5500.                                        will assume you are in zone 2. This
  5501.                                        is used to specify your own zone.
  5502.  
  5503.          DEFAULT <cost>                Defines the default Netmail cost.
  5504.  
  5505.          ZONE <zone> <cost>            Defines the Netmail cost for zone
  5506.                                        <zone>.
  5507.  
  5508.          REGION <region> <cost>        Defines the Netmail cost for region
  5509.                                        <region> within your own zone.
  5510.  
  5511.          NET <net> <cost>              Defines the Netmail cost for net
  5512.                                        <net> within your own zone.
  5513.  
  5514.  
  5515.  
  5516.  
  5517.  
  5518.  
  5519.  
  5520.  
  5521.  
  5522.  
  5523.  
  5524.  
  5525.                                       - 98 -
  5526.  
  5527.  
  5528.  
  5529.          A simple example for a node in Belgium, where the BBS is part
  5530.          of only ONE network.
  5531.  
  5532.            MYZONE   2         I'm in zone 2
  5533.            DEFAULT   100      Default = 100 credits
  5534.            ZONE     3 50      Zone 3 = 50 credits (Australia)
  5535.            ZONE     1 40      Zone 1 = 40 credits (North-America)
  5536.            REGION  28 10      Region 28 = 10 credits (Netherlands)
  5537.            REGION  29  0      Region 29 = FREE (Belgium)
  5538.            NET    512  5      Net 512 = 5 (HCC Netherlands)
  5539.  
  5540.  
  5541.          We give another example for a node which is part of 2 networks,
  5542.          so this node has nodenumbers 2:292/1900 and 89:120/40
  5543.  
  5544.            DEFAULT    100     Default = 100 credits
  5545.            ZONE     1  50     Zone 1  =  50 credits
  5546.            ZONE     2  20     Zone 2  =  20 credits
  5547.            ZONE     3  70     Zone 4  =  70 credits
  5548.            ZONE    89  10     My private network = 10 credits
  5549.  
  5550.            MYZONE   2         Following definitions are for zone 2
  5551.            REGION  29   1     Region 29 in zone 2  = 1 credit
  5552.            NET    292   0     Net 292   in zone 2  = 0 credits
  5553.            NET    512   5     Net 512   in zone 2  = 5 credits
  5554.  
  5555.            MYZONE  89         Following definitions are for zone 89
  5556.            REGION  12  2      Region 12 in zone 89 = 2 credits
  5557.            NET    120  0      Net 120   in zone 89 = 0 credits
  5558.  
  5559.  
  5560.  
  5561.         ┌──────────────────────────────────────────────────────────────────┐
  5562.         │ [MU] Music Player                                                │
  5563.         └──────────────────────────────────────────────────────────────────┘
  5564.  
  5565.          Use this to play/test any music files you create for ProBoard.
  5566.  
  5567.          Music files MUST have .MUS as the file extension.  The file played
  5568.          when a user "Yells" for the Sysop (paging) is called PAGE.MUS and
  5569.          the "Attention" music file is called ATTEN.MUS
  5570.  
  5571.              Examples:  PBUTIL PAGE  (plays the paging music file)
  5572.                         PBUTIL ATTEN (plays the attention music file)
  5573.  
  5574.  
  5575.                         PBUTIL MU to play a music file.
  5576.  
  5577.  
  5578.  
  5579.  
  5580.  
  5581.                                       - 99 -
  5582.  
  5583.  
  5584.  
  5585.         ╒══════════════════════════════════════════════════════════════════╕
  5586.         │░░░░░░ REFERENCE ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  5587.         ╘══════════════════════════════════════════════════════════════════╛
  5588.  
  5589.  
  5590.         ┌──────────────────────────────────────────────────────────────────┐
  5591.         │ Multi-user Operation                                             │
  5592.         └──────────────────────────────────────────────────────────────────┘
  5593.  
  5594.  
  5595.          Since ProBoard is a multi-line BBS package, it allows you the
  5596.          ability to have more than one user use the userfile and the
  5597.          message base at the same time. ProBoard doesn't do any internal
  5598.          multi-tasking to make the program act as flexible as possible.
  5599.          This makes sure that you can set up a multi-line BBS via a network
  5600.          and multiple computers, or by running ProBoard under a multitasking
  5601.          system. ProBoard has some code built in to run it as efficiently as
  5602.          possible under DESQview. It is also compatible with the new
  5603.          multitasking version of DR-DOS.
  5604.  
  5605.          ProBoard can handle up to 255 nodes. Each node needs its own
  5606.          directory, because ProBoard supports the use of an external
  5607.          message editor. These editors were designed to be used on
  5608.          single-node systems. Each node MUST be started from its own
  5609.          private directory. No ProBoard-related files have to be placed in
  5610.          this directory (only the files needed for the external message
  5611.          editor).
  5612.  
  5613.  
  5614.          If you want to install 3 nodes in a network, you could create
  5615.          the following structure:
  5616.  
  5617.              C:\PB\MSGBASE           Message base directory
  5618.              C:\PB\TXTFILES          Textfiles directory
  5619.              C:\PB\MENUS             Menus directory
  5620.              C:\PB\PEX               PEX files directory
  5621.  
  5622.              C:\PB\NODE1             Start-up directory for node 1
  5623.              C:\PB\NODE2             Start-up directory for node 2
  5624.              C:\PB\NODE3             Start-up directory for node 3
  5625.  
  5626.  
  5627.  
  5628.  
  5629.  
  5630.  
  5631.  
  5632.  
  5633.  
  5634.  
  5635.  
  5636.  
  5637.                                       - 100 -
  5638.  
  5639.  
  5640.  
  5641.          ProBoard should be started from C:\PB\NODE1 for node 1, from
  5642.          C:\PB\NODE2 for node 2, etc. These directories only require the
  5643.          files for the external editor. All the other files that ProBoard
  5644.          uses, should be stored in ProBoard's system directory (usually
  5645.          C:\PB).
  5646.  
  5647.          If you run ProBoard under a multitasker like DESQview, the
  5648.          different nodes MUST be run on different com-ports.
  5649.  
  5650.          ┌───────────┬────────────────────────────────────────────────────┐
  5651.          │ IMPORTANT │ If you are running ProBoard multi-line using a     │
  5652.          ├───────────┘ multitasker, the DOS program SHARE.EXE MUST! be    │
  5653.          │             installed.                             ────        │
  5654.          └────────────────────────────────────────────────────────────────┘
  5655.  
  5656.  
  5657.  
  5658.         ┌──────────────────────────────────────────────────────────────────┐
  5659.         │ Sysop Keys                                                       │
  5660.         └──────────────────────────────────────────────────────────────────┘
  5661.  
  5662.          While the user is on-line, the Sysop can perform several actions,
  5663.          by using the Sysop keys:
  5664.  
  5665.  
  5666.          Left/Right                    Lower/Raise the current user's level.
  5667.                                        Only the levels configured in PROCFG
  5668.                                        can be selected.
  5669.  
  5670.          Up/Down                       Raise/Lower the current user's time
  5671.                                        left. The time subtracted/added is
  5672.                                        not restricted to this session!
  5673.  
  5674.          Alt-C   [Chat]                Start a chat with the user. The chat
  5675.                                        may be ended by pressing <Esc>.
  5676.  
  5677.          Alt-J   [Jump]                Jump to DOS. If 'Swapping' was set to
  5678.                                        'Yes' in PROCFG, the ProBoard session
  5679.                                        will be swapped to disk or EMS, thus
  5680.                                        making all memory available to the
  5681.                                        DOS commands you want to execute.
  5682.                                        You can return from the shell by
  5683.                                        entering EXIT at the DOS prompt.
  5684.  
  5685.          Alt-H   [HangUp]              Hangs up the phone, throwing the
  5686.                                        user off-line immediately
  5687.                                        (very unfriendly)!
  5688.  
  5689.  
  5690.  
  5691.  
  5692.  
  5693.                                       - 101 -
  5694.  
  5695.  
  5696.  
  5697.          Alt-L   [LockOut]             Hangs up the phone AND sets the
  5698.                                        user's level to 0, thus making sure
  5699.                                        he/she cannot log in any more
  5700.                                        (very very unfriendly)!
  5701.  
  5702.          Alt-N   [NoChat]              Makes ProBoard shut up during this
  5703.                                        session.
  5704.                                        Comes in VERY handy when you see the
  5705.                                        user-that-ALWAYS-wants-to-chat is
  5706.                                        logging in.
  5707.  
  5708.          Alt-E   [Edit]                Allows you to edit the user
  5709.                                        online. The editor is similar to
  5710.                                        the editor in ProCFG.
  5711.  
  5712.          Alt-I   [Image]               Appends an image of the screen to
  5713.                                        the file IMAGE.TXT in the ProBoard
  5714.                                        system directory.
  5715.  
  5716.          Alt-R  [Reset]                Resets the chat request status. This
  5717.                                        will stop the flashing of the status
  5718.                                        line.
  5719.  
  5720.          Alt-S  [Static]               What can I say.  Useful in  
  5721.                                        combination with the ALT-H to help 
  5722.                                        you, the friendly Sysop, free up 
  5723.                                        your board when needed.  (somewhat 
  5724.                                        friendlier) ;-)
  5725.  
  5726.          Shift-F1                      Shows a help-screen with all the
  5727.                                        Sysop macros available.  (registered
  5728.                                        version only)
  5729.  
  5730.          F1                            Shows a help-screen with all the
  5731.                                        Sysop keys available.
  5732.  
  5733.          PgUp/PgDn                     Shows additional information about
  5734.                                        the current user on the status line.
  5735.                                        You can also display a particular
  5736.                                        status by pressing F2-F10.
  5737.  
  5738.          Home                          Shows the normal status line after
  5739.                                        using PgUp/PgDn.
  5740.  
  5741.          F2                            Shows the user's name, level, time
  5742.                                        left and time online.
  5743.  
  5744.          F3                            Shows the user's handle and flags.
  5745.  
  5746.  
  5747.  
  5748.  
  5749.                                       - 102 -
  5750.  
  5751.  
  5752.  
  5753.          F4                            Shows the user's city and phone
  5754.                                        numbers.
  5755.  
  5756.          F5                            Shows statistics about the
  5757.                                        current user.
  5758.  
  5759.          F6                            Shows the user's comment line.
  5760.  
  5761.          F7                            Shows system information.
  5762.  
  5763.          F8                            Shows the chat reason if the user
  5764.                                        tried to page the Sysop earlier.
  5765.  
  5766.          F9                            Shows the name and login time of the
  5767.                                        last caller.
  5768.  
  5769.          F10                           Shows the time used and Kbytes
  5770.                                        downloaded today. It also displays
  5771.                                        the date of birth of the current user.
  5772.  
  5773.  
  5774.          Furthermore, there are 10 programmable hotkeys (Sysop macros).
  5775.          They can be configured in ProCFG.
  5776.  
  5777.          There are 2 kinds of Sysop macros:
  5778.  
  5779.             - Key macros   : With this type of macro, it is possible to
  5780.                              assign many keystrokes to a single key.
  5781.                              When the macro key is pressed, all keys
  5782.                              specified will be passed to ProBoard, as if
  5783.                              you typed them yourself.
  5784.  
  5785.                              Special chars: '|' is replaced by <Enter>
  5786.                                             '^' is replaced by <Esc>
  5787.  
  5788.             - Shell macros : You can link any DOS command to a macro's hot-
  5789.                              key. A shell-definition MUST start with a '@'.
  5790.                              The string following the '@' should contain
  5791.                              the DOS command to be executed. You can,
  5792.                              of course, use the special shell options from
  5793.                              menu function 7.
  5794.  
  5795.                              Take this for an example:
  5796.  
  5797.                              Suppose you have set 'Swapping' to 'No' in
  5798.                              ProCFG. Should you, however, need ALL your
  5799.                              system memory in the shell, you could define
  5800.                              the following macro: @*C*N*Q*X (COMMAND.COM,
  5801.                              NoLog, NoMsg, Swapping).
  5802.  
  5803.  
  5804.  
  5805.                                       - 103 -
  5806.  
  5807.  
  5808.  
  5809.         ┌──────────────────────────────────────────────────────────────────┐
  5810.         │ Command line parameters & Errorlevels                            │
  5811.         └──────────────────────────────────────────────────────────────────┘
  5812.  
  5813.          PROBOARD.EXE accepts following command line parameters:
  5814.  
  5815.  
  5816.          PROBOARD [-B<baud>] [-P<port>] [-N<node>] [-L<level]
  5817.  
  5818.  
  5819.  
  5820.  
  5821.  
  5822.  
  5823.  
  5824.  
  5825.  
  5826.  
  5827.  
  5828.  
  5829.  
  5830.  
  5831.  
  5832.  
  5833.  
  5834.  
  5835.  
  5836.  
  5837.  
  5838.  
  5839.  
  5840.  
  5841.  
  5842.  
  5843.  
  5844.  
  5845.  
  5846.  
  5847.  
  5848.  
  5849.  
  5850.  
  5851.  
  5852.  
  5853.  
  5854.  
  5855.  
  5856.  
  5857.  
  5858.  
  5859.  
  5860.  
  5861.                                       - 104 -
  5862.  
  5863.  
  5864.  
  5865.                   [-T<time>] [-S] [-Q] [-X] [-V<mode>]
  5866.  
  5867.  
  5868.          These parameters have the following meaning:
  5869.  
  5870.             -B<baud>   Specifies the baud rate. You can specify the
  5871.                        following baud rates: 300, 1200, 2400, 4800, 7200,
  5872.                        9600, 12000, 14400, 19200 and 38400.
  5873.  
  5874.             -P<port>   Specifies the com-port (1-8).
  5875.  
  5876.             -N<node>   This node's node number (1-255).
  5877.  
  5878.             -L<level>  Prevents people with a security level lower than this
  5879.                        level to access this node.  Great for only allowing
  5880.                        subscribing user access to one or more nodes.
  5881.  
  5882.             -T<time>   <time> is the time until the next event in minutes.
  5883.                        Useful with FrontDoor's DOBBS batch file.
  5884.  
  5885.             -S         Start ProBoard in stand alone mode.  ProBoard will
  5886.                        use as a default the PORT and the BAUD specified
  5887.                        in your configuration, but you can override them
  5888.                        by using the -P<port> and the -B<baud> command line
  5889.                        parameters along with the -S parameter.
  5890.  
  5891.             -Q         Quiet mode.  Great if your BBS is in a location such
  5892.                        as your bedroom etc.  The only noise ProBoard will
  5893.                        make is playing the ATTEN.MUS file (if a user who
  5894.                        has this set in their user record logs on), and
  5895.                        playing the PAGE tune when a user pages during valid
  5896.                        paging hours.
  5897.  
  5898.             -X         Tells ProBoard not to use EMS.
  5899.  
  5900.             -V<mode>   Runs ProBoard in video mode <mode>. This can be
  5901.                        useful if you have a monitor capable of displaying
  5902.                        132 columns, and you would like to run ProBoard in
  5903.                        such a mode (you will see an extra information
  5904.                        window on your screen if ProBoard is run in
  5905.                        132 cols mode). The <mode> parameter is a decimal
  5906.                        number specifying the video mode, as it is used with
  5907.                        INT 10H, function 00. (only programmers will 
  5908.                        understand this though :-)
  5909.  
  5910.          When no '-B<x>' and no '-S' parameter is given, ProBoard will be
  5911.          started in local mode.
  5912.  
  5913.  
  5914.  
  5915.  
  5916.  
  5917.                                       - 105 -
  5918.  
  5919.  
  5920.  
  5921.          ProBoard returns an errorlevel when a user has logged off.
  5922.  
  5923.          The errorlevels of PROBOARD.EXE are:
  5924.  
  5925.               0    Everything OK, normal logoff.
  5926.  
  5927.               1    FATAL error, something 'terrible' happened, or the
  5928.                    modem could not be initialized.
  5929.  
  5930.               2    Not used.
  5931.  
  5932.               3    Netmail entered by the user.
  5933.  
  5934.               4    Echomail entered by the user.
  5935.  
  5936.               5    Echomail AND Netmail entered by the user.
  5937.  
  5938.              99    Sysop pressed <Esc> at the "Waiting for call" screen.
  5939.  
  5940.  
  5941.  
  5942.  
  5943.  
  5944.  
  5945.  
  5946.  
  5947.  
  5948.  
  5949.  
  5950.  
  5951.  
  5952.  
  5953.  
  5954.  
  5955.  
  5956.  
  5957.  
  5958.  
  5959.  
  5960.  
  5961.  
  5962.  
  5963.  
  5964.  
  5965.  
  5966.  
  5967.  
  5968.  
  5969.  
  5970.  
  5971.  
  5972.  
  5973.                                       - 106 -
  5974.  
  5975.  
  5976.  
  5977.         ┌──────────────────────────────────────────────────────────────────┐
  5978.         │ AVATAR/0 and AVATAR/0+ Terminal Emulation                        │
  5979.         └──────────────────────────────────────────────────────────────────┘
  5980.  
  5981.          ProBoard now supports AVATAR terminal emulation.  It allows users
  5982.          to select either AVATAR/0 or AVATAR/0+, providing that the terminal
  5983.          package they use to call your BBS is compatibile with either
  5984.          AVATAR/0 and/or AVATAR/0+.  Examples of terminal software packages
  5985.          that support AVATAR/0+ are, FrontDoor 2.02 and TinyTerm.
  5986.          QModem and Telix also support AVATAR, but only in the AVATAR/0
  5987.          mode.  AVATAR has the advantage over ANSI of being much faster.
  5988.  
  5989.          A word about the files extensions (.A??) that are used for AVATAR
  5990.          screens.  There are two file extensions that are associated with
  5991.          AVATAR text files that you will display to your users.  They are
  5992.          .AVT and .AVP.  When displaying (.A??) textfiles to your users,
  5993.          ProBoard looks for them in the following order.
  5994.  
  5995.            1.) .AVP
  5996.            2.) .AVT
  5997.            3.) .ANS
  5998.            4.) .ASC
  5999.  
  6000.         Refer to the following section on "Hard Coded .A?? files" for more
  6001.         information on the default .A?? files that ProBoard will display to
  6002.         your users.
  6003.  
  6004.         To create files with the .AVT and .AVP file extensions you will
  6005.         need a file utility called AVTCONV.EXE.  This file was distributed
  6006.         with RemoteAccess, and is also available from most of the ProBoard
  6007.         beta sites, as well as any of the ProBoard Support BBS's.  It is
  6008.         very simple to use this utility.  Just copy it to your ProBoard
  6009.         TEXTFILE directory and run the following commands.
  6010.  
  6011.         AVTCONV *.ANS AVT       -- this will create a copy of all of your
  6012.                                 ANSI (.ANS) screens with the extension .AVT
  6013.                                 These are the textfiles for displaying to
  6014.                                 users that have AVATAR/0 terminal emulation
  6015.                                 selected.
  6016.  
  6017.         AVTCONV /C+ *.ANS AVP   -- this will create a copy of all of your
  6018.                                 ANSI (.ANS) screens with the extension .AVP
  6019.                                 These are the textfiles for displaying to
  6020.                                 users that have AVATAR/0+ terminal emulation
  6021.                                 selected.
  6022.  
  6023.  
  6024.  
  6025.  
  6026.  
  6027.  
  6028.  
  6029.                                       - 107 -
  6030.  
  6031.  
  6032.  
  6033.         ┌──────────────────────────────────────────────────────────────────┐
  6034.         │ Hard-coded .A?? files                                            │
  6035.         └──────────────────────────────────────────────────────────────────┘
  6036.  
  6037.          In certain situations, ProBoard will display default .A?? files.
  6038.  
  6039.          .A?? files are defined as files that have the file extensions
  6040.           of .AVT, .AVP, .ANS, and .ASC.  If the .ANS/AVT/AVP file cannot
  6041.           be found, the .ASC file will be displayed (if it exists).
  6042.  
  6043.          Note: You have to insert your own "Press [Enter] to continue"
  6044.          prompt if necessary!
  6045.  
  6046.  
  6047.          INTRO.A??      Displayed when a user logs in, BEFORE asking a
  6048.                         user's name and password.
  6049.  
  6050.          GOODBYE.A??    Displayed when the user is logging off, just
  6051.                         before the carrier is dropped.
  6052.  
  6053.          NEWUSER1.A??   Displayed when a new user is logging in,
  6054.                         BEFORE he/she has started the questionnaire.
  6055.  
  6056.          NEWUSER2.A??   Displayed when a new user is logging in, AFTER
  6057.                         he/she has completed the questionnaire.
  6058.  
  6059.          WELCOMEx.A??   Displayed at login, after the user entered
  6060.                         his/her name.  The 'x' stands for a digit
  6061.                         ranging from 1 to 9; these files (if they
  6062.                         xist) will be displayed in ascending order,
  6063.                         1-2-...-9, BEFORE a mailcheck is done.
  6064.  
  6065.          NEWS.A??       Displayed AFTER the user has read his/her
  6066.                         new mail.
  6067.  
  6068.          SECxx.A??      'xx' stands for a userlevel. If a user with
  6069.                         level xx logs in, this file will be displayed
  6070.                         (eg. SEC25.ANS). The file is shown after all
  6071.                         WELCOME<x> files and before the mailcheck.
  6072.  
  6073.          MAXPAGE.A??    Displayed when the user has tried to page the
  6074.                         Sysop too many times.
  6075.  
  6076.          PAGED.A??      Displayed when the Sysop does not respond when
  6077.                         the user tries to page.
  6078.  
  6079.          NOTAVAIL.A??   Displayed when the user tries to page outside
  6080.                         paging hours.
  6081.  
  6082.  
  6083.  
  6084.  
  6085.                                       - 108 -
  6086.  
  6087.  
  6088.  
  6089.          MSGHELP.A??    Replaces the built-in message reading help if
  6090.                         this file exists.
  6091.  
  6092.          PRIVATE.A??    Is displayed when your system is configured as a
  6093.                         private system, and a new user tries to log in.
  6094.  
  6095.          EXP_WARN.A??   Displayed when the user's level expires within
  6096.                         less than 30 days.
  6097.  
  6098.          EXPIRED.A??    When a user's level has expired, this file is
  6099.                         shown.
  6100.  
  6101.          TRASHCAN.A??   Shown when a user tries to use a name listed
  6102.                         in TRASHCAN.CTL file.
  6103.  
  6104.  
  6105.          EVENTDUE.A??   Shown if a user can't login because of an event
  6106.                         that has to run soon.
  6107.  
  6108.  
  6109.          BIRTHDAY.A??   If a user logs in on his/her birthday, this
  6110.                         file will be shown after the news file.
  6111.                         Note: you can run a pex-file to congratulate a
  6112.                         user on his/her birthday.
  6113.  
  6114.          DLDELAY.A??    Displayed to a user who has to wait <n> minutes
  6115.                         before downloading. Refer to Configuration -
  6116.                         Time/DownLoad Limits (F5) for more information on
  6117.                         setting the number of minutes for the DownLoad
  6118.                         Delay.
  6119.  
  6120.          DLHANGUP.A??   Displayed to a user who has selected [G]oodbye
  6121.                         after download, after the 10 second timer to
  6122.                         abort the hangup, has expired.
  6123.  
  6124.  
  6125.  
  6126.  
  6127.  
  6128.  
  6129.  
  6130.  
  6131.  
  6132.  
  6133.  
  6134.  
  6135.  
  6136.  
  6137.  
  6138.  
  6139.  
  6140.  
  6141.                                       - 109 -
  6142.  
  6143.  
  6144.  
  6145.         ┌──────────────────────────────────────────────────────────────────┐
  6146.         │ .A?? File Control Codes                                          │
  6147.         └──────────────────────────────────────────────────────────────────┘
  6148.  
  6149.          You can use several codes in ProBoard's textfiles. These codes
  6150.          will be replaced by internal variables, or will perform special
  6151.          actions.
  6152.  
  6153.          In the code list, you will see a code's ASCII value, the control
  6154.          code and a description of the code.
  6155.  
  6156.          A '^' means Ctrl, so ^D means Ctrl-D.
  6157.  
  6158.  
  6159.          ┌───────┬──────┬─────────────────────────────────────────────────┐
  6160.          │ ASCII │ CODE │  DESCRIPTION                                    │
  6161.          ├───────┼──────┼─────────────────────────────────────────────────┤
  6162.          │   65  │  ^A  │ Waits for the user to press <Enter>.            │
  6163.          │   66  │  ^B  │ Disables interruption by pressing <S>.          │
  6164.          │   67  │  ^C  │ Enables interruption by pressing <S>.           │
  6165.          │   68  │  ^D  │ Enables 'More'-prompt.                          │
  6166.          │   69  │  ^E  │ Disables 'More'-prompt.                         │
  6167.          │   71  │  ^G  │ Rings a bell on the user's computer.            │
  6168.          │   76  │  ^L  │ Clearscreen.                                    │
  6169.          │   87  │  ^W  │ Pauses for 1 second.                            │
  6170.          └───────┴──────┴─────────────────────────────────────────────────┘
  6171.  
  6172.  
  6173.  
  6174.  
  6175.  
  6176.  
  6177.  
  6178.  
  6179.  
  6180.  
  6181.  
  6182.  
  6183.  
  6184.  
  6185.  
  6186.  
  6187.  
  6188.  
  6189.  
  6190.  
  6191.  
  6192.  
  6193.  
  6194.  
  6195.  
  6196.  
  6197.                                       - 110 -
  6198.  
  6199.  
  6200.  
  6201.          ┌───────┬──────┬─────────────────────────────────────────────────┐
  6202.          │ ASCII │ CODE │  DESCRIPTION                                    │
  6203.          ├───────┼──────┼─────────────────────────────────────────────────┤
  6204.          │ 06-65 │ ^FA  │ User's full name.                               │
  6205.          │ 06-66 │ ^FB  │ User's City.                                    │
  6206.          │ 06-67 │ ^FC  │ User's password.                                │
  6207.          │ 06-68 │ ^FD  │ User's data/fax phone number.                   │
  6208.          │ 06-69 │ ^FE  │ User's phone number.                            │
  6209.          │ 06-71 │ ^FG  │ Time of last login.                             │
  6210.          │ 06-76 │ ^FL  │ Netmail credit left.                            │
  6211.          │ 06-77 │ ^FM  │ Number of messages written.                     │
  6212.          │ 06-78 │ ^FN  │ Message last read.                              │
  6213.          │ 06-79 │ ^FO  │ User's level.                                   │
  6214.          │ 06-80 │ ^FP  │ Number of calls by user.                        │
  6215.          │ 06-81 │ ^FQ  │ Number of uploads by user.                      │
  6216.          │ 06-82 │ ^FR  │ Kbytes uploaded by user.                        │
  6217.          │ 06-83 │ ^FS  │ Number of downloads by user.                    │
  6218.          │ 06-84 │ ^FT  │ Kbytes downloaded by user.                      │
  6219.          │ 06-85 │ ^FU  │ Number of minutes online today.                 │
  6220.          │ 06-86 │ ^FV  │ User's screen length.                           │
  6221.          │ 06-87 │ ^FW  │ User's first name.                              │
  6222.          │ 06-88 │ ^FX  │ ANSI codes ON/OFF.                              │
  6223.          │ 06-89 │ ^FY  │ Screen pausing ON/OFF.                          │
  6224.          │ 06-90 │ ^FZ  │ Clearscreen codes ON/OFF.                       │
  6225.          │ 06-48 │ ^F0  │ Fullscreen editor ON/OFF.                       │
  6226.          │ 06-49 │ ^F1  │ User's Alias.                                   │
  6227.          │ 06-50 │ ^F2  │ Command stacking ON/OFF.                        │
  6228.          │ 06-51 │ ^F3  │ IBM Characters ON/OFF.                          │
  6229.          │ 06-52 │ ^F4  │ User's country.                                 │
  6230.          │ 06-53 │ ^F5  │ User's birth date.                              │
  6231.          │ 06-54 │ ^F6  │ User's expiration date (if any)                 │
  6232.          │ 06-55 │ ^F7  │ Day's until expiration date.                    │
  6233.          │ 06-56 │ ^F8  │ AVATAR/0  - on/off.                             │
  6234.          │ 06-57 │ ^F9  │ AVATAR/0+  - on/off.                            │
  6235.          │ 06-91 │ ^F[  │ Download Kb left today.                         │
  6236.          │ 06-126│ ^F~  │ Download delay in minutes.                      │
  6237.          │ 06-33 │ ^F!  │ # Minutes remaining until allowed to download.  │
  6238.          └───────┴──────┴─────────────────────────────────────────────────┘
  6239.  
  6240.  
  6241.  
  6242.  
  6243.  
  6244.  
  6245.  
  6246.  
  6247.  
  6248.  
  6249.  
  6250.  
  6251.  
  6252.  
  6253.                                       - 111 -
  6254.  
  6255.  
  6256.  
  6257.          ┌───────┬──────┬─────────────────────────────────────────────────┐
  6258.          │ ASCII │ CODE │   DESCRIPTION                                   │
  6259.          ├───────┼──────┼─────────────────────────────────────────────────┤
  6260.          │ 11-65 │ ^KA  │ Total number of calls to the BBS.               │
  6261.          │ 11-66 │ ^KB  │ Name of the last user on the BBS.               │
  6262.          │ 11-67 │ ^KC  │ Number of active messages.                      │
  6263.          │ 11-68 │ ^KD  │ Number of first message.                        │
  6264.          │ 11-69 │ ^KE  │ Number of last message.                         │
  6265.          │ 11-70 │ ^KF  │ Number of times user has paged the Sysop.       │
  6266.          │ 11-71 │ ^KG  │ Day of the week (full).                         │
  6267.          │ 11-72 │ ^KH  │ Number of users on the BBS.                     │
  6268.          │ 11-73 │ ^KI  │ Current time.                                   │
  6269.          │ 11-74 │ ^KJ  │ Today's date.                                   │
  6270.          │ 11-75 │ ^KK  │ Minutes online during this session.             │
  6271.          │ 11-77 │ ^KM  │ Minutes online today.                           │
  6272.          │ 11-79 │ ^KO  │ Minutes online left today.                      │
  6273.          │ 11-80 │ ^KP  │ Version number of ProBoard (x.xx)               │
  6274.          │ 11-81 │ ^KQ  │ Daily online limit.                             │
  6275.          │ 11-82 │ ^KR  │ Baud rate.                                      │
  6276.          │ 11-83 │ ^KS  │ Day of the week (short).                        │
  6277.          │ 11-84 │ ^KT  │ Daily download limit (Kbytes).                  │
  6278.          │ 11-87 │ ^KW  │ Node number.                                    │
  6279.          │ 11-88 │ ^KX  │ Hang up phone.                                  │
  6280.          │ 11-89 │ ^KY  │ Active message area name.                       │
  6281.          │ 11-90 │ ^KZ  │ Active file area name.                          │
  6282.          │ 11-48 │ ^K0  │ # Messages in active message area               │
  6283.          │ 11-49 │ ^K1  │ Current message area #                          │
  6284.          │ 11-50 │ ^K2  │ Current file area #                             │
  6285.          └───────┴──────┴─────────────────────────────────────────────────┘
  6286.  
  6287.  
  6288.          You can also inform ProBoard about the length of a string to be
  6289.          placed in a textfile. This is done is the following way:
  6290.  
  6291.          Between the first and last code, you can place '@' or '#' codes.
  6292.          The field's length will be defined by the number of characters,
  6293.          first and last control code included. Use '@' to align (justify)
  6294.          a field to the left, use '#' to align to the right.
  6295.  
  6296.  
  6297.              Eg. ^K@@@@@@@@@@@@@@@@@@@@@@@B
  6298.                   ^^^^^^^^^^^^^^^^^^^^^^^
  6299.                         23 X '@'
  6300.  
  6301.          Thus, the total amount of characters equals 25, the user's name
  6302.          (^KB) will be placed in a 25-character field, left justified. You
  6303.          now can easily draw 'boxes' around this field, without having to
  6304.          worry about the actual length of the user's name.
  6305.  
  6306.  
  6307.  
  6308.  
  6309.                                       - 112 -
  6310.  
  6311.  
  6312.  
  6313.          An example of a textfile using the control codes: (the '^' stands
  6314.          for '^F') :
  6315.  
  6316.  
  6317.           ┌───────────┐
  6318.           │ Some Info │
  6319.           └───┬───────┴───────────────────────────────────────────────────┐
  6320.               │ Your full name..... ^@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@A    │
  6321.               │ Calling from....... ^@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@B    │
  6322.               │ Last called........ ^@@@@@@@@@F at ^@@@@@@G               │
  6323.               │ Level.............. ^####O                                │
  6324.               │ Number of calls.... ^####P                                │
  6325.               ├──────────────────────────────┬────────────────────────────┤
  6326.               │ Kb downloaded...... ^@@@@TK  │ Kb uploaded....... ^####RK │
  6327.               │ # downloads........ ^####S   │ # uploads......... ^####Q  │
  6328.               ├──────────────────────────────┴────────────────────────────┤
  6329.               │ Messages posted.... ^####M                                │
  6330.               │ Your flags......... ^@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@H    │
  6331.               ├─────────────────┐                                         │
  6332.               │ ANSI        ^#X ├─────────────────────────────────────────┘
  6333.               │ Clearscreen ^#Z │
  6334.               │ More prompt ^#Y │
  6335.               │ Editor      ^#O │
  6336.               └─────────────────┘  Press <Enter> to continue.^A
  6337.  
  6338.  
  6339.  
  6340.         ┌──────────────────────────────────────────────────────────────────┐
  6341.         │ Music Files                                                      │
  6342.         └──────────────────────────────────────────────────────────────────┘
  6343.  
  6344.          You can make your paging-sound and attention-sound more attractive
  6345.          by defining your own musicfile. A musicfile is a text file in
  6346.          which you can use 2 keywords:
  6347.  
  6348.            TONE [hz] [1/100's sec]      Sounds a tone of [hz] Hz during
  6349.                                         the specified period.
  6350.  
  6351.            WAIT [1/100's sec]           Waits for the specified period.
  6352.  
  6353.  
  6354.          The format of this textfile is compatible with the RemoteAccess
  6355.          musicfiles.
  6356.  
  6357.          The paging-musicfile is named PAGE.MUS, and the attention-music-
  6358.          file is named ATTEN.MUS.
  6359.  
  6360.  
  6361.  
  6362.  
  6363.  
  6364.  
  6365.                                       - 113 -
  6366.  
  6367.  
  6368.  
  6369.          You can use this frequency-table to write your own masterpiece:
  6370.  
  6371.                  ┌──────┬─────┬─────┬──────┬──────┬──────┐
  6372.                  │  O.1 │ O.2 │ O.3 │  O.4 │  O.5 │  O.6 │
  6373.             ┌────┼──────┼─────┼─────┼──────┼──────┼──────┤
  6374.             │ C  │   45 │ 134 │ 268 │  536 │ 1071 │ 2145 │
  6375.             │ C# │   71 │ 142 │ 284 │  568 │ 1136 │ 2273 │
  6376.             │ D  │   75 │ 150 │ 301 │  602 │ 1204 │ 2408 │
  6377.             │ D# │   80 │ 159 │ 319 │  638 │ 1275 │ 2551 │
  6378.             │ E  │   84 │ 169 │ 338 │  676 │ 1351 │ 2703 │
  6379.             │ F  │   90 │ 179 │ 358 │  716 │ 1432 │ 2864 │
  6380.             │ F# │   95 │ 190 │ 379 │  758 │ 1517 │ 3034 │
  6381.             │ G  │  100 │ 201 │ 402 │  804 │ 1607 │ 3215 │
  6382.             │ G# │  106 │ 213 │ 426 │  851 │ 1703 │ 3406 │
  6383.             │ A  │  113 │ 225 │ 451 │  902 │ 1804 │ 3608 │
  6384.             │ A# │  119 │ 239 │ 478 │  956 │ 1991 │ 3823 │
  6385.             │ B  │  127 │ 253 │ 506 │ 1012 │ 2025 │ 4050 │
  6386.             └────┴──────┴─────┴─────┴──────┴──────┴──────┘
  6387.  
  6388.  
  6389.  
  6390.         ┌──────────────────────────────────────────────────────────────────┐
  6391.         │ Text Macros                                                      │
  6392.         └──────────────────────────────────────────────────────────────────┘
  6393.  
  6394.          You can enter text macros in any user-definable string. Text
  6395.          macros are defined as "@<NAME:n>@", and are replaced by internal
  6396.          ProBoard variables at runtime.
  6397.          You can insert these macros in the following strings:
  6398.  
  6399.            - Textlines in menu items
  6400.            - Data fields in menu items
  6401.            - Menu prompts
  6402.            - "Yelling" message for Menu Function 11
  6403.            - "Shelling" message for Menu Function 7
  6404.            - Modem initialization string
  6405.  
  6406.  
  6407.          'NAME' is the name of the macro. A list of available macros will
  6408.          follow.
  6409.  
  6410.          You can also specify the field width for the resulting string.
  6411.          This is done by appending the macro name with a ':' and a number.
  6412.          A positive number will result in a left aligned string, while a
  6413.          negative number will result in a right aligned string.
  6414.  
  6415.          For example: @<NAME:30>@ will display the user's name in a left
  6416.          aligned field of 30 characters wide.
  6417.  
  6418.          Note that the field width specifier is optional.
  6419.  
  6420.  
  6421.                                       - 114 -
  6422.  
  6423.  
  6424.  
  6425.          Here is a list of the available macros:
  6426.  
  6427.            BAUD              Current baud rate
  6428.            CITY              The city of the current user
  6429.            COUNTRY           User's country/state
  6430.            CURFILEAREA       Current file area name
  6431.            CURFILEAREA#      Current file area number
  6432.            CURMENU           Current menu name
  6433.            CURMSGAREA        Current message area name
  6434.            CURMSGAREA#       Current message area number
  6435.            DATAPHONE         User's data phone number
  6436.            DATE              Current date (xx-xxx-xx)
  6437.            FIRSTNAME         The first name of the current user
  6438.            HANDLE            The user's handle (fixed alias)
  6439.            HIGHMSG           Highest message number in message base
  6440.            ID                The user level ID for this user
  6441.            LASTDATE          Date of user's last call
  6442.            LASTTIME          Time of user's last call
  6443.            LEVEL             The level of the current user
  6444.            LOWMSG            Lowest message number in message base
  6445.            MNUDIR            Menu directory
  6446.            MSGDIR            Messagebase directory
  6447.            NAME              The name of the current user
  6448.            NLDIR             Nodelist directory
  6449.            NODE              Current node number
  6450.            NUMMSG            Number of messages in current area
  6451.            NUMUSERS          Total number of users in userfile
  6452.            NUMYELLS          The number of times the user yelled
  6453.            PASSWORD          The user's password
  6454.            PEXDIR            PEX-files directory
  6455.            PORT              Current com-port nr (1-8)
  6456.            PVTDIR            Private uploads directory
  6457.            STARTDIR          Startup-directory
  6458.            SYSDIR            ProBoard system directory
  6459.            SYSOPNAME         Name of the Sysop
  6460.            TIME              Current time (xx:xx)
  6461.            TMLEFT            Number of minutes left
  6462.            TMONLINE          Number of minutes online
  6463.            TOTALCALLS        Total number of calls to the system
  6464.            TOTALMSG          Total number of messages in message base
  6465.            TXTDIR            Textfiles directory
  6466.            UPDIR             Upload directory
  6467.            USERREC           Record number of this user's user record
  6468.            VERSION           ProBoard version number (eg 1.22)
  6469.            VOICEPHONE        User's voice phone number
  6470.  
  6471.  
  6472.  
  6473.  
  6474.  
  6475.  
  6476.  
  6477.                                       - 115 -
  6478.  
  6479.  
  6480.  
  6481.            %NAME             Will be replaced by the contents of DOS
  6482.                              environment variable 'NAME'.
  6483.                              Example: in DOS or a .BAT file you would put
  6484.                                       SET INITSTR=ATDT5551212.  Then when
  6485.                                       you use a text macro like this:
  6486.                                       @<%INITSTR>@ it would be replaced
  6487.                                       with "ATDT5551212".  Note
  6488.                                       the "%" symbol in the macro.
  6489.  
  6490.            Other special characters are:
  6491.  
  6492.            #1 - #7           Change color (only valid for displayable
  6493.            #B1 - #B7         strings). If a 'B' is in front of the color
  6494.                              number, the "blink" attribute will be turned
  6495.                              on.
  6496.                                      1 = Red
  6497.                                      2 = Green
  6498.                                      3 = Yellow
  6499.                                      4 = Blue
  6500.                                      5 = Magenta
  6501.                                      6 = Cyan
  6502.                                      7 = White
  6503.  
  6504.  
  6505.          Example:  Hi @<#3>@@<FIRSTNAME>@@<#7>@, how is the weather in @<CITY>@?
  6506.  
  6507.          Other single examples:   @<NAME:35>@
  6508.                                   @<TMONLINE:-5>@
  6509.                                   @<CITY>@
  6510.  
  6511.  
  6512.  
  6513.  
  6514.  
  6515.  
  6516.  
  6517.  
  6518.  
  6519.  
  6520.  
  6521.  
  6522.  
  6523.  
  6524.  
  6525.  
  6526.  
  6527.  
  6528.  
  6529.  
  6530.  
  6531.  
  6532.  
  6533.                                       - 116 -
  6534.  
  6535.  
  6536.  
  6537.         ┌──────────────────────────────────────────────────────────────────┐
  6538.         │ Example Batch Files                                              │
  6539.         └──────────────────────────────────────────────────────────────────┘
  6540.  
  6541.          This is an example for standalone-operation with 2 errorlevel
  6542.          events defined. Event 1 returns level 10, event 2 returns level
  6543.          20. No echomail and netmail is used.
  6544.  
  6545.          ------------------------------------------------------------------
  6546.              :Loop
  6547.              PROBOARD -S
  6548.              if errorlevel 99 goto End
  6549.              if errorlevel 20 goto Event2
  6550.              if errorlevel 10 goto Event1
  6551.              if errorlevel 1 goto FatalError
  6552.              goto Loop
  6553.  
  6554.              :Event1
  6555.              echo Perform some actions
  6556.              echo --------------------
  6557.              goto Loop
  6558.  
  6559.              :Event2
  6560.              echo Perform some more actions
  6561.              echo -------------------------
  6562.              goto Loop
  6563.  
  6564.              :FatalError
  6565.              echo FATAL ERROR - ProBoard Down
  6566.              :End
  6567.          ------------------------------------------------------------------
  6568.  
  6569.  
  6570.          Using ProBoard with a frontend-mailer is a little more
  6571.          complicated. This is an example for use with FrontDoor.
  6572.  
  6573.          In this example FrontDoor uses the following errrolevels:
  6574.  
  6575.             300 bps call : 50
  6576.            1200 bps call : 51
  6577.            2400 bps call : 52
  6578.            Local call    : 60
  6579.            Mail received : 100
  6580.            Exit          : 150
  6581.  
  6582.  
  6583.  
  6584.  
  6585.  
  6586.  
  6587.  
  6588.  
  6589.                                       - 117 -
  6590.  
  6591.  
  6592.  
  6593.          ------------------------------------------------------------------
  6594.              SET FD=C:\FD
  6595.  
  6596.              :Loop
  6597.              cd \fd
  6598.              fd
  6599.              if errorlevel 150 goto End
  6600.              if errorlevel 100 goto MailRcv
  6601.              cd\pb
  6602.              if errorlevel  60 goto Local
  6603.              if errorlevel  52 goto Call2400
  6604.              if errorlevel  51 goto Call1200
  6605.              if errorlevel  50 goto Call300
  6606.  
  6607.              :FatalErr
  6608.              echo FATAL ERROR
  6609.              goto End
  6610.  
  6611.              :Call300
  6612.              proboard -b300 -p1
  6613.              goto CheckPBErr
  6614.  
  6615.              :Call1200
  6616.              proboard -b1200 -p1
  6617.              goto CheckPBErr
  6618.  
  6619.              :Call2400
  6620.              proboard -b2400 -p1
  6621.              goto CheckPBErr
  6622.  
  6623.              :Local
  6624.              proboard
  6625.  
  6626.              :CheckPBErr
  6627.              if errorlevel 5 goto NetEcho
  6628.              if errorlevel 4 goto EchoEntered
  6629.              if errorlevel 3 goto NetEntered
  6630.              if errorlevel 1 goto FatalErr
  6631.              goto Loop
  6632.  
  6633.              :NetEcho
  6634.              REM ************************************
  6635.              REM ** Export netmail & echomail here **
  6636.              REM ************************************
  6637.              Goto Loop
  6638.  
  6639.  
  6640.  
  6641.  
  6642.  
  6643.  
  6644.  
  6645.                                       - 118 -
  6646.  
  6647.  
  6648.  
  6649.              :NetEntered
  6650.              REM ************************************
  6651.              REM **      Export netmail here       **
  6652.              REM ************************************
  6653.              Goto Loop
  6654.  
  6655.              :EchoEntered
  6656.              REM ************************************
  6657.              REM **      Export echomail here      **
  6658.              REM ************************************
  6659.              Goto Loop
  6660.  
  6661.              :MailRcv
  6662.              REM ************************************
  6663.              REM **  Unpack and Import mail here   **
  6664.              REM ************************************
  6665.              Goto Loop
  6666.  
  6667.              :End
  6668.          ------------------------------------------------------------------
  6669.  
  6670.  
  6671.  
  6672.  
  6673.  
  6674.  
  6675.  
  6676.  
  6677.  
  6678.  
  6679.  
  6680.  
  6681.  
  6682.  
  6683.  
  6684.  
  6685.  
  6686.  
  6687.  
  6688.  
  6689.  
  6690.  
  6691.  
  6692.  
  6693.  
  6694.  
  6695.  
  6696.  
  6697.  
  6698.  
  6699.  
  6700.  
  6701.                                       - 119 -
  6702.  
  6703.  
  6704.  
  6705.         ┌──────────────────────────────────────────────────────────────────┐
  6706.         │ Flag Cross-Reference Chart                                       │
  6707.         └──────────────────────────────────────────────────────────────────┘
  6708.  
  6709.  
  6710.          The following cross-reference chart will help you to easily
  6711.          determine which flags to use for your user records and menus
  6712.          using the ProBoard style (A-Z and 1-6) of flags.
  6713.  
  6714.          Note:  The flag structures in ProBoard are actually no different
  6715.          than those in QuickBBS or RA, they are just expressed in a more
  6716.          "user friendly" format.
  6717.  
  6718.                ╔═══╦═══╤═══╤═══╤═══╤═══╤═══╤═══╤═══╕
  6719.                ║   ║ 1 │ 2 │ 3 │ 4 │ 5 │ 6 │ 7 │ 8 │
  6720.                ╠═══╬═══╧═══╧═══╧═══╧═══╧═══╧═══╧═══╛
  6721.                ║ A ║ A   B   C   D   E   F   G   H
  6722.                ╟───╢
  6723.                ║ B ║ I   J   K   L   M   N   O   P
  6724.                ╟───╢
  6725.                ║ C ║ Q   R   S   T   U   V   W   X
  6726.                ╟───╢
  6727.                ║ D ║ Y   Z   1   2   3   4   5   6
  6728.                ╙───╜
  6729.  
  6730.  
  6731.          A few flag examples follow:
  6732.  
  6733.                QuickBBS/RA                ProBoard
  6734.                ───────────                ────────
  6735.                    A1                        A
  6736.                    C3                        S
  6737.                    D7                        5
  6738.                    C8                        X
  6739.  
  6740.          well.... you get the idea.
  6741.  
  6742.  
  6743.  
  6744.  
  6745.  
  6746.  
  6747.  
  6748.  
  6749.  
  6750.  
  6751.  
  6752.  
  6753.  
  6754.  
  6755.  
  6756.  
  6757.                                       - 120 -
  6758.  
  6759.  
  6760.  
  6761.         ┌──────────────────────────────────────────────────────────────────┐
  6762.         │ FREE Files                                                       │
  6763.         └──────────────────────────────────────────────────────────────────┘
  6764.  
  6765.          Many Sysops have a master file list containing all the files
  6766.          available on their BBS for users to download, or perhaps some virus
  6767.          detection software that they would like to make available to their
  6768.          users without affecting their users download ratio.
  6769.  
  6770.          It is possible (in addition to marking entire file areas) to specify
  6771.          a list of files that users can download without ProBoard deducting
  6772.          the kilobyte amount of the download from their daily limit.  To
  6773.          accomplish this, create a file called FREEFILE.CTL in the ProBoard
  6774.          system directory (usually C:\PB).  Create this file with an ascii
  6775.          editor such as QEDIT.  Each line in the file should contain the name
  6776.          (do not include the drive and path to the file) and extension of any
  6777.          files you want to make available for FREE.  Wildcards are allowed.
  6778.  
  6779.          An example follows:
  6780.  
  6781.            PB_122.ARJ
  6782.            FILELIST.ZIP
  6783.            *.TXT
  6784.            SCANV86.ZIP
  6785.            PB_STRUC.*
  6786.            LIST.LZH
  6787.  
  6788.  
  6789.  
  6790.  
  6791.  
  6792.  
  6793.  
  6794.  
  6795.  
  6796.  
  6797.  
  6798.  
  6799.  
  6800.  
  6801.  
  6802.  
  6803.  
  6804.  
  6805.  
  6806.  
  6807.  
  6808.  
  6809.  
  6810.  
  6811.  
  6812.  
  6813.                                       - 121 -
  6814.  
  6815.  
  6816.  
  6817.         ╒═════════════════════════════════════════════════════════════════╕
  6818.         │░░░░░░░ USER'S GUIDE TO PROBOARD ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  6819.         ╘═════════════════════════════════════════════════════════════════╛
  6820.  
  6821.          This chapter explains the use of ProBoard from the caller's
  6822.          perspective.
  6823.  
  6824.  
  6825.         ┌──────────────────────────────────────────────────────────────────┐
  6826.         │ Navigating Through Menus                                         │
  6827.         └──────────────────────────────────────────────────────────────────┘
  6828.  
  6829.          ProBoard has been created for the novice and experienced user. It
  6830.          supports Opus-like commands and RA/QBBS style hotkeys. Using
  6831.          hotkeys is the easiest way to navigate through the menus. While a
  6832.          menu is being displayed, you can enter any menu command. The
  6833.          displaying of the menu will be stopped, and the corresponding menu
  6834.          function will be executed immediately.
  6835.          The other way to enter menu options is command stacking. This way
  6836.          you can enter several menu commands at a prompt, and execute them
  6837.          all at once by pressing [Enter]. You are not limited to menu
  6838.          commands only. You can enter any key that should be "stacked". A
  6839.          ';' stands for <Enter>.
  6840.          This asks for an example I guess. Suppose you are in a menu where
  6841.          option [E] selects the "Enter Message" function.  Now, if you
  6842.          want to write a private message to the Sysop, using "Test" as a
  6843.          subject, you could enter:
  6844.  
  6845.             ESysop;Test;Y
  6846.  
  6847.          E          "Enter Message"
  6848.          Sysop      "Write message to" prompt
  6849.          ;          Enter
  6850.          Test       "Subject" prompt
  6851.          ;          Enter
  6852.          Y          Answer to "Private [Y/N]" prompt
  6853.  
  6854.          If you don't like to use command stacking all the time, but want
  6855.          to use it occasionally, you can enter a ';' at any menu prompt,
  6856.          and you will be able to enter a "command stack".
  6857.  
  6858.  
  6859.  
  6860.  
  6861.  
  6862.  
  6863.  
  6864.  
  6865.  
  6866.  
  6867.  
  6868.  
  6869.                                       - 122 -
  6870.  
  6871.  
  6872.  
  6873.         ┌──────────────────────────────────────────────────────────────────┐
  6874.         │ The MORE prompt                                                  │
  6875.         └──────────────────────────────────────────────────────────────────┘
  6876.  
  6877.          If text is about to scroll off the screen, ProBoard asks the user
  6878.          if he/she would like to continue (if enabled). The user can enter
  6879.          3 keys: [Y] to continue reading, [N] to stop reading or [C] to
  6880.          continue reading without further prompting.
  6881.  
  6882.  
  6883.  
  6884.         ┌──────────────────────────────────────────────────────────────────┐
  6885.         │ The [S] & [P] key                                                │
  6886.         └──────────────────────────────────────────────────────────────────┘
  6887.  
  6888.          You can stop almost any incoming text with the [S] key, and pause
  6889.          with [P] key. To resume a paused text, press [P] again or press
  6890.          the <Enter> key. The Sysop can disable this though.
  6891.  
  6892.  
  6893.  
  6894.         ┌──────────────────────────────────────────────────────────────────┐
  6895.         │ Standard Chatting Procedure                                      │
  6896.         └──────────────────────────────────────────────────────────────────┘
  6897.  
  6898.          New Sysops may not be familiar with online "chatting". There is
  6899.          one important thing you should know. It makes life much easier for
  6900.          you and the person you're chatting with.
  6901.          If you expect a response from the other side after you typed
  6902.          something, you should hit <Enter> twice to insert a blank line.
  6903.          This way the person on the other side knows you are done.
  6904.  
  6905.  
  6906.  
  6907.  
  6908.  
  6909.  
  6910.  
  6911.  
  6912.  
  6913.  
  6914.  
  6915.  
  6916.  
  6917.  
  6918.  
  6919.  
  6920.  
  6921.  
  6922.  
  6923.  
  6924.  
  6925.                                       - 123 -
  6926.  
  6927.  
  6928.  
  6929.         ╒══════════════════════════════════════════════════════════════════╕
  6930.         │░░░░░░░ SOFTWARE DEVELOPMENT KIT ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  6931.         ╘══════════════════════════════════════════════════════════════════╛
  6932.  
  6933.         Included with ProBoard is the ProBoard Software Development Kit
  6934.         (SDK).
  6935.  
  6936.         The SDK allows C and C++ programmers to write extensions to
  6937.         ProBoard.  The ProBoard Software Development Kit is bundled with
  6938.         ProBoard as free software.  This means that you may use it to write
  6939.         extensions for ProBoard without having to register ProBoard.  The
  6940.         only exception of course, is if you are using ProBoard to run a BBS
  6941.         on a regular basis.
  6942.  
  6943.        The extensions you can write for ProBoard are called "PEX" (ProBoard
  6944.        Executable) files.  You may distribute any ProBoard PEX files you
  6945.        write royalty free.
  6946.  
  6947.        Just what exactly can a ProBoard Executable (PEX) file do?
  6948.  
  6949.        To illustrate what a PEX file is, we have bundled the shareware
  6950.        version of a PEX file called "EFL" (Enhanced File List) for your
  6951.        enjoyment and use.  EFL is intended to enhance the normal file
  6952.        listing ProBoard displays when calling Menu Function 31 (List Files).
  6953.        Please refer to the next chapter "Enhanced File List (EFL) PEX File"
  6954.        for more information on installing and using this sample PEX file.
  6955.  
  6956.        Any PEX files you create with the SDK are run from within ProBoard
  6957.        using Menu Function 60 (Run ProBoard SDK file).
  6958.  
  6959.        For more information on using the ProBoard Software Development Kit
  6960.        (SDK) and the functions that it contains, please refer to the file
  6961.        included with this release of ProBoard, called "PB122SDK.DOC".
  6962.  
  6963.  
  6964.  
  6965.  
  6966.  
  6967.  
  6968.  
  6969.  
  6970.  
  6971.  
  6972.  
  6973.  
  6974.  
  6975.  
  6976.  
  6977.  
  6978.  
  6979.  
  6980.  
  6981.                                       - 124 -
  6982.  
  6983.  
  6984.  
  6985.  
  6986.         ╒══════════════════════════════════════════════════════════════════╕
  6987.         │░░░░░░░ ENHANCED FILE LIST (EFL) PEX FILE ░░░░░░░░░░░░░░░░░░░░░░░░│
  6988.         ╘══════════════════════════════════════════════════════════════════╛
  6989.  
  6990.          The Enhanced File List PEX file provides ProBoard with the
  6991.          ability to list and tag files.  EFL was designed to give the
  6992.          Sysop complete control over the color regions of the file list,
  6993.          word-wrap, tag character, and more. A configuration utility
  6994.          (EFLCFG.EXE) is provided to setup EFL very quickly.
  6995.  
  6996.          For more information on EFL, and how to install it, please refer
  6997.          to the EFL documentation in the file EFL130.ARJ.
  6998.  
  6999.  
  7000.  
  7001.         ┌──────────────────────────────────────────────────────────────────┐
  7002.         │ FrontDoor Notes - High Speed Modems Only                         │
  7003.         └──────────────────────────────────────────────────────────────────┘
  7004.  
  7005.                                   Read CAREFULLY
  7006.                                   ──────────────
  7007.  
  7008.         In the FDSETUP, under Modem -> Messages: change the 1200 line
  7009.         from "CONNECT 1200" to "CONNECT 1200/".  Also make sure you add
  7010.         an errorlevel for 12000 in the FDSETUP, under Misc -> Errorlevels.
  7011.         Then in your BBS.BAT (or whatever you call it) file, add the
  7012.         necessary support for responding to that errorlevel.  This way
  7013.         FrontDoor will support 12000 bps connects and pass them properly
  7014.         to ProBoard.
  7015.  
  7016.         This will allow FrontDoor to properly answer 12000 bps calls, which
  7017.         otherwise come in at CONNECT 1200.  Of course, you will need the
  7018.         proper modem (like a USR Dual Standard) in order for users to connect
  7019.         at 12000 bps.
  7020.  
  7021.  
  7022.  
  7023.  
  7024.  
  7025.  
  7026.  
  7027.  
  7028.  
  7029.  
  7030.  
  7031.  
  7032.  
  7033.  
  7034.  
  7035.  
  7036.  
  7037.  
  7038.                                       - 125 -
  7039.